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PREFACE 



This manual describes the System Generation/32 (Sysgen/32) 
program and the procedures to produce a 32-bit operating system. 
This manual is intended for system programmers and operators. 

Chapter 1 introduces the sysgen command substitution system (CSS) 
procedure and describes its phases. Chapter 1 also explains how 
to load and start the Sysgen/32 program. The Sysgen/32 commands 
that cause a configuration input file to be processed are 
described in detail. Chapter 2 details the sysgen configuration 
input statements that make up the input file, and includes data 
communication configuration statements. Chapter 3 lists and 
describes the libraries required by the Sysgen/32 program and 
explains how to tailor library modules to user needs and include 
the modified modules in the appropriate library. Chapter 3 also 
explains how to include user-written drivers and modules in the 
system. Chapter 4 details the OS/32-supported devices. Chapter 
5 is written for the less experienced user and contains sample 
Sysgen/32 sessions. 

Appendix A compares the Sysgen/32 and the OS/32 Configuration 
Utility Program (CUP) configuration statement defaults. Appendix 
B lists the sysgen messages, and Appendix C is a summary of the 
Sysgen/32 commands and configuration statements. Appendix D 
compares OS/32 CUP and Sysgen/32 configuration statements. 

Revision 02 introduces the new Model 3205 System. New 
configuration statements have been added to be used in the sysgen 
interactive mode. Enhancements have been made to the file 
manager. New system source modules and supported features have 
been included. With the R07 . 2 release, new macros have been 
introduced to the Sysgen/32 Macro Library. Support for virtual 
disk and mirror disk is documented. Configuration statements to 
enable the generation of an operating system for a Model 3200MPS 
System are clearly marked as pertaining to the Model 3200MPS 
System only. This manual applies to the OS/32 R07 . 2 software 
release and higher. 

For information on the contents of all Perkin-Elmer 32-bit 
manuals, see the 32-Bit Systems User Documentation Summary. 
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CHAPTER 1 
INTRODUCTION TO SYSTEM GENERATION/32 (SYSOEN/32) 



1.1 INTRODUCTION 

Sysgen/32 is a program designed to enable a user to create and 
tailor an operating system to accommodate particular system 
requirements. In Sysgen/32, hardware and software features for 
the operating system are selected and defined through the use of 
sysgen configuration statements. These statements are defined in 
a sysgen configuration input file. Driver and system modules 
provided in the OS/32 package are selected by Sysgen/32, based on 
the requirements indicated in these sysgen statements. 

The user can create a new configuration input file or modify an 
existing configuration input file using Sysgen/32 commands. The 
EDIT command enables the user to use all of the OS/32 Edit 
command repertoire. The HELP and the CONVERSATIONAL commands are 
available to help the user create a configuration input file. 

Once a configuration input file is created, it is processed by 
the Sysgen/32 program to produce macro calls. These macros are 
subsequently expanded, assembled and linked to yield an operating 
system. Figure 1-1 details the step-by-step process that results 
in the generation of an operating system using Sysgen/32. 
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As shown in Figure 1-1, the sysgen process involves four general 
steps . 

1. A configuration input file is created and processed via the 
Sysgen/32 program, resulting in a set of macro calls. 

2. The macro calls are expanded using Common Assembly Language 
(CAL) Macro/32. 

3. The expanded macros are assembled using CAL/32, resulting in 
object modules. 

4. The object modules are linked using OS/32 Link to yield an 
operating system. 

The user has the option to perform these steps in a single 
process by using a command substitution system (CSS) procedure 
called sysgen CSS, and executing each program in the overall 
procedure. 

1.2 CREATING AN OPERATING SYSTEM USING THE SYSTEM GENERATION 
(SYSGEN) COMMAND SUBSTITUTION SYSTEM (CSS) 

The sysgen CSS can be used to create an operating system with 
minimal user interaction. The user creates the sysgen 
configuration input file and passes the filename and other 
optional parameters to the CSS. 

The macro generation, expansion, assembly and linkage steps are 
automatically performed according to the sysgen CSS instructions. 
Figure 1-2 details the components of the sysgen CSS. 
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Figure 1-2 Generation of an Operating System Using the 
Sysgen CSS 



1.2.1 Starting the System Generation (Sysgen) Command 
Substitution System (CSS) 

The following format is used when starting the SYSGEN CSS, 



Format: 



SYSGEN input f ilename Q segs ize increment] 



{Library volume] 
user volume j 

[j Macro and CAL listing flag] [7 file save flag] 
(2 list filename] 



Parameters 



input 
f i lename 



segsize 
increment 



is the 1- to 8-character 
configuration input file, 
default extension of 
configuration input file, 
specified does not exist, 
generated and the CSS will 

is a decimal number spec i i 
kb of workspace required by 
The default is 40kb. 



name of 


the sysgen 


The CSS 


assumes a 


.SYS 


for the 


If 


the file 


an error 


message is 


abort . 




ying the number of 


the sysgen task. 



library 
volume 



Macro and 
CAL listing 
flag 



file 
flag 



save 



is a 1- to 4~c 
the disk volume 
by CAL Macro/32 
The libraries 
account (/P) or 
If this parameter 
is the default. 



haracter name (with colon) of 

; containing the libraries used 

and Link during CSS execution. 

can be on the user's private 

on the system account (/S) . 

is omitted, the user volume 



is the parameter that determines what files 
will be printed in the list file. If this 
parameter is entered, all intermediate files 
are sent to the list file after the sysgen 
process is completed. If this parameter is 
omitted, only error messages are sent to the 
list file after the sysgen process is 
completed. Enter a YES to indicate that 
intermediate files are to be printed. 

is the parameter that causes the CSS to save 
all intermediate files created during the 
sysgen process. If this parameter is omitted, 
all of the intermediate files created during 
sysgen are deleted. Enter a YES if 
intermediate files are to be saved. 
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list is the file descriptor (fd) of the list file 

filename to which all messages are written. If this 

parameter is omitted, a default file with the 
input filename.PRT is allocated. 

Example: 

SYSGEN OS32SYS,30,M300: , PRINT1, YES , LIST1 

This example initiates the sysgen CSS and passes the following 
information to the CSS: 

• OS32SYS is the configuration input file. An extension of .SYS 
is assumed by the CSS. 

• The segment size increment is 30. 

• M300: is the library volume containing the libraries used by 
CAL Macro/32 and Link. 

• PRINT1 is the file that will receive the CAL Macro/32 or 
CAL/3 2 list output for debugging purposes. 

• The YES flag indicates all intermediate files are not to be 
deleted. 

• LIST1 is the list file for messages. 

Functional Details: 

If an error occurs during the execution of the sysgen CSS, an 
error message is written to the console and the CSS is aborted. 
If the CSS reaches a successful completion, the following 
information is displayed to the console: 

• Operating system map filename = (input f i lename ) . LST or 
user-specified fd 

• Operating system object filename = (input f i lename ) . OB J 

• Operating system task filename =■ (output volume name + input 
f i lename) .OS 

1-6 48-037 F00 R02 



1.2.2 Components of the System Generation (Sysgen) Command 
Substitution System (CSS) 

The SYSGEN CSS is comprised of three CSS modules: 



• SYSGEN32.CSS 

• SYSMACRO . CSS 

• SYSLINK.CSS 



These modules can be run independently , outside of the sysgen CSS 
procedure. However, when they are executed independently, the 
user must pass the appropriate parameters to each CSS. It is 
particularly useful to be able to execute the SYSLINK CSS routine 
independently, since this enables a previously linked operating 
system to be relinked to incorporate changes in system and driver 
library modules. The following sections detail the procedures 
for executing the SYSGEN32, SYSMACRO and SYSLINK CSS routines 
independently. 

1.2.2.1 Executing the SYSGEN32 Command Substitution System (CSS) 

The SYSGEN32 CSS executes the Sysgen/32 program, which processes 
the sysgen configuration input file and generates macro calls. 

Format: 



SYSGEN32 input filename (Tsegsize increment] 



Parameters: 



input 
f ilename 



is the 1- to 8-character name of the sysgen 
configuration input file. The CSS assumes a 
.SYS extension for the configuration input 
file. If the file specified does not exist, 
an error message is generated and the CSS 
aborts . 



segsize 
increment 



is a decimal number specifying the number of 
kb of workspace required by the sysgen task. 
The default is 40kb. 
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Functional Details: 

If the CSS encounters an error while executing (end of task code 
other than 0), an error message is generated and the CSS aborts. 
The list file should be checked for errors. If the CSS reaches 
a successful completion (end of task code = 0), the file 
containing the macro calls generated by the Sysgen/32 program 
will be contained in a file named: 



(input f ilename) .MAC 



This file is used by the next CSS procedure, SYSMACRO. 

1.2.2.2 Executing the SYSMACRO Command Substitution System (CSS) 

The SYSMACRO CSS takes the macro calls generated by the Sysgen/32 
program, expands them using CAL Macro/32, and assembles the 
expanded source modules using CAL/32. 



Format: 



SYSMACRO macro output filename 



{library volume! 
user volume )_ 
(Tlisting flag] Q,save files flag] £list filename] 



Parameters: 



macro output 
f i lename 



library 
volume 



is the 1- to 8-character name of the file 
containing the macro calls generated by the 
Sysgen/32 program. The CSS assumes an 
extension of .MAC. If the specified file does 
not exist, an error message is generated and 
the CSS aborts . 

is the name (colon included) of the disk 
volume containing the libraries used by CAL 
Macro/32 during CSS execution. The macro 
libraries (.MLB) can be on the user's private 
account (/P) or on the system account (/S) . 
If this parameter is omitted, the user volume 
is the default. 



listing 
flag 



means a complete listing of macro expansion 
and assembly is desired. If this parameter is 
omitted, only error messages are listed. 
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save means that intermediate files created during 

files flag the sysgen process are to be saved. If this 

parameter is not entered, all intermediate 

files are deleted. 



list 
filename 



is the fd of the last file 
messages are written. If this 
omitted, a default file with 
filename.LST is allocated. 



to which all 

parameter is 

the name input 



Functional Details: 

If the CSS encounters an error (end of task code other 
an error message is generated and the CSS aborts. 



than 0) , 



If the CSS reaches a successful completion (end of task 
code = 0), the object module assembled by CAL/32 will be 
contained in a file named: 



(macro output f ilename) .OBJ 



This file will be used by the next CSS routine, SYSLINK CSS. 

1.2.2.3 Executing the SYSLINK Command Substitution System (CSS) 

The SYSLINK CSS takes the object modules assembled in the 
SYSMACRO CSS and links the object with the appropriate libraries 
to produce an operating system. 



Format: 



SYSLINK object filename 



(library volume)" 
( user volume ) 



Qfiles save flag] 



Parameters: 



object 
f i lename 



is the 1- to 8-character name of the file 
containing the CAL object code generated 
during the SYSMACRO CSS. If the specified 
file does not exist, an error message is 
generated and the CSS is aborted. 
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library is the name (colon included) of the volume 
volume where the system and driver libraries reside. 

The system libraries (.LIB) can be on the 
user's private account (/P) or on the system 
account (/S). If this parameter is omitted, 
the user volume is the default. 

file save is the parameter that causes the CSS to save 
flag all intermediate files created during the 

sysgen process. If this parameter is omitted 
all of the intermediate files created during 
the sysgen procedure are deleted. 

Functional Details: 

If an error occurs during execution of the SYSLINK CSS (end of 
task code other than 0) , an error message is generated and the 
CSS is aborted. 

If the CSS reaches a successful completion, the following 
information is displayed: 

• Operating system map filename - (object f ilename) .LST or a 

user -specif ied fd 

• Operating system object file - (object f ilename) .OBJ 

• Operating system task file = (output volume name + object 

f ilename) .OS 

1.3 USING THE SYSTEM GENERATION/32 (SYSGEN/32) PROGRAM 

The Sysgen/32 program enables a user to create and/or process a 
sysgen configuration input file to generate macro calls. The 
option to process a previously generated configuration input file 
or interactively create and process a new configuration input 
file is available. 

The Sysgen/32 program runs in batch and interactive environments. 
In a batch environment, the program processes the configuration 
input file without user interaction. In an interactive 
environment, the user can create the configuration input file 
directly from the command device and correct run-time errors as 
they occur . 

1.3.1 Loading and Starting the System Generation/32 (Sysgen/32) 
Program 

The following commands are used to load and start the Sysgen/32 
program. 
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1.3.1.1 LOAD Command 

The system LOAD command loads Sysgen/32 into memory. 

Format: 

LOAD SYSGEN32 [Tsegsize increment] 
Parameter: 



segsize is an optional parameter that specifies the 
increment workspace required by the sysgen task. This 

increment must be large enough to accommodate 
processing of all the configured devices. The 
default is 40kb. 

If the segsize is not large enough, the 
message: 



LINE ADDR STACK OVERFLOW 

TASK PAUSED 



will be displayed. The task must then be 
cancelled and reloaded with a larger 
increment. 
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START 



1.3.1.2 START Command 

The system START command begins execution of the Sysgen/3 2 
program. All parameters are optional. 



Format: 



START [7lNPUT-fd3 (TQUTPUT-f d 2 ^J [TfiOMMAND-fdJ (TLIST-fd^ 



Parameters: 



INPUT- 



OUTPUT- 



COMMAND- 



LI ST= 



fd-i specifies the configuration input file to 
be processed by the Sysgen/32 program. The 
input file must be an existing file. 

fd 2 specifies the output file to which macro 
calls generated by Sysgen/32 will be written. 
The output file cannot be an existing file. 

fd 3 specifies the command input device. This 
parameter establishes whether the environment 
is batch or interactive. If an interactive 
device is specified, the environment is 
interactive. CON: is the default for a 
command device. 

fd4 specifies the device or file to which all 
list output and messages generated during 
sysgen execution are sent. If the list 
parameter specifies a file, the file must 
already exist. PR: is the default list 
device . 



Functional Details: 

If the START command is entered with both INPUT and OUTPUT 
parameters specified and the command device is omitted, the 
Sysgen/32 program will immediately process the configuration 
input file and assume a batch environment unless the input file 
is empty. 



If the specified input file is empty, the 
the following message: 



program will display 



READY FOR CONFIGURATION INPUT 
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The program then waits for the user to interactively input 
configuration input statements that will be used to create the 
configuration input file. 

If the START command is entered without the INPUT and OUTPUT 
parameters, the Sysgen/32 commands described in the following 
sections can be used to: 



• Create a sysgen input file in a conversational mode 
( CONVERS AT I ONAL ) . 

• Specify the configuration input file (INPUT). 

• Specify the macro output file (OUTPUT). 

• Modify the sysgen configuration input file (EDIT). 

• Initiate processing of the sysgen configuration input file 
(PROCESS). 

The HELP command is also available as a user aid. 
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1.4 SYSTEM GENERATION/ 3 2 (SYSGEN/32) COMMANDS 
The following Sysgen/32 commands are available: 

• INPUT 

• OUTPUT 

• CONVERSAT I ONAL 

• EDIT 

• HELP 

• PAUSE 

• PROCESS 

• END 
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INPUT 



1.4.1 INPUT Command 

The INPUT command specifies a configuration input file to be used 
as input to the Sysgen/32 program. This command is used if the 
INPUT parameter was not specified with the START command. 

Format: 

INPUT fd 
Parameter: 



fd is the file descriptor of a configuration 

input file to be processed by the Sysgen/32 
program. 

Functional Details: 

If the specified input file is empty and the command device is an 
interactive device, the input file can be created either by 
entering configuration statements directly from the command 
device after the PROCESS command is entered or conversationally 
(see Section 1.4.3). 
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OUTPUT 



1.4.2 OUTPUT Command 



The OUTPUT command specifies an output file to receive the macro 
calls generated by Sysgen/32. This command is used if the OUTPUT 
parameter was not specified with the START command. 

Format: 

OUTPUT fd 

Parameter: 

fd is the file descriptor of the file that 

receives the Sysgen/32-generated macro calls. 



Functional Details: 

The specified output file must be an empty, nonexistent file. If 
the OUTPUT command is entered with the name of an existing file, 
an error is generated. 
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CONVERSATIONAL 



1.4.3 CONVERSATIONAL Command 

The CONVERSATIONAL command initiates a sysgen prompt and user 
response session in an interactive environment. This prompt and 
response session is a user aid in creating a configuration input 
f i le . 



Format: 



CONVERSATIONAL 



Functional Details: 

The Sysgen/32 program issues interactive prompts relating to the 
hardware configuration and software options. The possible 
responses, in parentheses, and the defaults, in brackets, are 
displayed after each prompt, where applicable. Defaults are 
taken if a carriage return (CR) is depressed for all but device 
prompts. A response must be entered for all device prompts. 

The program will create sysgen configuration statements based on 
the responses to the prompts. Acceptable statements will be 
written to the specified input file. Nonacceptable statements or 
responses will cause the program to generate an error message and 
to reissue the appropriate prompt, or prompts, until an 
acceptable response is entered. 

If the CONVERSATIONAL command is entered before an input file was 
defined via the INPUT command or INPUT parameter of the START 
command, the following message is displayed: 

INPUT MUST BE ENTERED 

When in CONVERSATIONAL mode, the user can access the HELP file by 
entering a question mark (?) in response to a prompt. The 
question mark causes the HELP file to display pertinent 
information about a configuration statement or parameter and 
briefly describes its use. The program then reissues the prompt 
sequence for the configuration statement. After all prompts have 
been issued, the following message is displayed: 

CONVERSATIONAL PROCESSING COMPLETE 
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The PROCESS command can then be entered to start the processing 
of the newly created input file. Certain errors will not be 
detected during the conversational session, but will be detected 
in the processing phase. These errors can be corrected using the 
EDIT command (see Section 1.4.4). 

Example: 

PROCESSOR MODEL ( 7/32 , 8/32 , 3200MPS , 3205 , 3210 , 3220 , 3230 , 3240 , 

3250) [3220] 
>? 
CPU: SPECIFIES THE 3 2 -BIT PROCESSOR MODEL. 

COMMAND FORMAT: CPU [N][,R] 

N IS THE MODEL NUMBER OF THE PROCESSOR. 

THE VALUE FOR N MAY BE: 

7/32, 8/32, 3200MPS, 3205, 3210, 3220, 
3230,3240,3250. 

R SPECIFIES THE NUMBER OF REGISTER SETS, 
2 OR 8. 

THE DEFAULT VALUES FOR THE CPU COMMAND ARE 
3220 WITH 8 REGISTER SETS. 
PROCESSOR MODEL ( 7/32 , 8/32 , 3200MPS , 3205 , 3210 , 3220 , 3230 , 3240 , 

3250) [3220] 
>CR 
NUMBER OF REGISTER SETS (2 OR 8) [8] 

O/S VERSION (8 CHAR. ALPHANUMERIC STRING) [BLANKS] 
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EDIT 



1.4.4 EDIT Command 

The EDIT command makes the entire OS/32 Edit command repertoire 
available to the user. This command is available during program 
execution in interactive mode only. 



Format : 



EDIT 



Functional Details: 

All of the OS/32 Edit commands can be used to correct or modify 
the configuration input file. When the changes are made and the 
file is saved, the END or DONE command terminates the edit 
session and returns control to the Sysgen/32 program. 



Example: 



> INPUT SYS 1. SYS 
> OUTPUT SYS1.MAC 
> PROCESS 



Specifies input and output 
files . 



ILLEGAL VALUE 3280 ) 
READY FOR SYSGEN COMMANDS/ 



Error is encountered. 

Sysgen program enters command 

input mode. 



Enters edit mode and corrects 
error . 



>EDIT 

READY FOR EDIT COMMANDS 

>GET SYS 1. SYS 

>OPT LIST=CON: 

>T/3280/ 

2 CPU 3280 

>SU/3280/3230/ 

>DONE 

WORKFILE - FIXD:SYS1.000 

RENUMBERED INPUT FILE AVAILABLE F IXD:SYS1 .SYS 

READY FOR SYSGEN COMMANDS* resume Sysgen/32 processing 

> PROCESS 1 
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HELP 



1.4.5 HELP Command 



The HELP command accesses the HELP file and displays sysgen 
commands and configuration statements. A brief description of 
each command or configuration statement and information on how to 
use each is also displayed. 



Format: 



HELP 




Parameters : 



name 



specifies the name of a specific sysgen 
statement or command to be displayed. 

specifies that all sysgen statements and 
commands be displayed. 



Functional Details: 

If the HELP command is entered without a parameter, the following 
message is displayed: 



For a list of commands type HELP * 

For help on any command mnemonic, type HELP <mnemonic> 
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Example 1: 



>HELP * 
I(NPUT) 
PA (USE) 
B(ACKGROUND) 
CS(S) 

DIR(ECTORY) 
ERRORR(EC) 
INT(ERCEPT) 
L(OGLEN) 
MCON(FIG) 
NOSE(G) 
SP(OOL) 
TC(OM) 
COOR(DINATION) 



O(UTPUT) 

PR(OCESS) 

CL(OCK) 

DA(TE) 

DI(SCBLOCK) 

F(LOAT) 

IR(EADER) 

LPU 

MEMCHECK 

TG(D) 

SPL(32) 

TE(MP) 

COPY 



CONV ( ERS AT I ONAL ) 
END 

CM(DLEN) 
DEVA(DS) 
DS(YS) 
IOC(LASS) 
IT(AM) 
MAXA(PU) 
ME(MORY) 
QU(EUE) 
ST(ARTUP) 
VER(SION) 
POW(ERFAIL) 



For HELP on any of the above command mnemonics, 
<mnemonic> 



ED(IT) 

ACC(OUNTING) 
CP(U) 
DEVI(CES) 
ENDC 
IL(EVEL) 
J(OURNAL) 
MAX (TASK) 
MIR(ROR) 
MO(DULE) 
R(OLL) 
SST(ABLE) 
V(OLUME) 
SL(ICE) 
type HELP 



Example 2: 



>HELP ACC 
ACCOUNTING: INCLUDES ACCOUNTING SUPPORT. 

COMMAND FORMAT: ACCOUNTING [{N}] [ ,NOF I LE AC COUNTING] 

N = DECIMAL VALUE FROM 2 THROUGH 32, SPECIFYING 
THE MAXIMUM NUMBER OF ACCOUNTING CLASSES 
DEFAULT FOR N - 4 . 

NO FILE ACCOUNTING SPECIFIES THAT FILE ACCOUNTING 
SUPPORT IS EXCLUDED. 
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PAUSE 



1.4.6 PAUSE Command 



The PAUSE command interrupts execution of the Sysgen/32 program 
and returns control to the operating system. 



Format: 

PAUSE 
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PROCESS 



1.4.7 PROCESS Command 

The PROCESS command initiates processing of the sysgen 
configuration input file. 

Format: 



PROCESS 



Functional Details: 

Do not use the PROCESS command if both a nonempty input file and 
an output file were specified as parameters of the START command, 
but no command device was entered. 
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! END i 

1.4.8 END Command 

The END command ends the Sysgen/32 program. 

Format: 

END 

Functional Details: 

An end of task code other than zero indicates that an error 
occurred during Sysgen/32 execution in a batch environment. 
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SYSTEM GENERATION/32 



CHAPTER 2 
(SYSGEN/32) CONFIGURATION STATEMENTS 



2.1 INTRODUCTION 

Sysgen configuration statements make up the configuration input 
file that defines the hardware and software features of the 
target operating system. The sysgen configuration statements 
are: 



ACCOUNTING 

BACKGROUND 

CLOCK 

CMDLEN 

COORDINATION 

COPY . . . ENDCOPY 

CPU 

CSS 

DATE 

DEVADS 

DEVICES. . .ENDD 

DIRECTORY 

DISCBLOCK 

DSYS 

END 

ERRORREC 



FLOAT 

I LEVEL 

INTERCEPT 

IOCLASS 

I READER 

ITAM 

JOURNAL 

LOGLEN 

LPU 

MAXAPU 

MAXTASK 

MCONFIG 

MEMCHECK 

MEMORY 

MIRROR 

MODULE . . . ENDM 



NOSEG 

POWERFAIL 

QUEUE 

ROLL 

SLICE 

SPOOL 

SPL32 

SSTABLE 

STARTUP . . 

TCOM 

TEMP 

TGD 

VERSION 

VOLUME 



ENDS 



Certain statements may span more than one line. A comma, input 
as the last nonblank character, indicates that the statement is 
continued on the next line. 

Any characters following an asterisk (*) are treated as comments. 
If an asterisk is in column 1, the entire line is treated as a 
comment line. Comment lines are copied to the list device. 



2.2 SYSTEM GENERATION (SYSGEN) CONFIGURATION STATEMENTS 



The following sections alphabetically present, 
detail, each sysgen configuration statement. 



and describe in 
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ACCOUNTING 



2.2.1 ACCOUNTING Statement 

The ACCOUNTING statement specifies that accounting support is 
included in the system. 



Format: 



ACCOUNTING [V] 




[7NOF ILEACCOUNT ing] 



Parameters: 



n 



is a decimal number from 2 to 32 that 
specifies the maximum number of device or 
file classes to be supported by the 
Accounting Facility. The minimum number 
of classes must be two, because two 
classes are needed to handle the four 
file types. If this parameter is 
omitted, 4 is the default. 



NOF I LEACCOUNT I NG 



prevents logging of accounting data when 
files are deleted or renamed. 



Functional Details: 

Each device or file class supported by the Accounting Facility 
must be defined by the IOCLASS statement. Each input/output 
(I/O) class supported by the Accounting Facility occupies 12 
bytes in the user task control block (TCB) and four bytes in the 
mu It i -terminal monitor (MTM) for each MTM user of the Accounting 
Facility. If the ACCOUNTING statement is omitted, accounting 
support is not included in the system. 



See the IOCLASS statement or IOCLASS 
statement for file or device classes. 



parameter of the device 



The NOF I LEACCOUNT ING option allows the user to reduce the size 
the account transaction file (ATF). 



of 
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Accounting support is required by the load- leveling executive | 
(L.LE) if used on the Model 3200MPS System. j 



NOTE 

The maximum number of I/O classes that 
are currently processed by the Accounting 
Reporting Utility is 10. See the OS/32 
System Support Utilities Reference 
Manual. 
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BACKGROUND 



2.2.2 BACKGROUND Statement 

The BACKGROUND statement establishes the maximum priority and 
maximum amount of system space for a background task in the 
system. 



Format: 



BACKGROUND [=] 



Imaxpr ior ityl 

1 11 I 



fmaxs ize) 



Parameters 



maxpr ior ity 



maxsize 



is a decimal value from 11 to 248 specifying 
the highest priority at which a background 
task can run. If this parameter is omitted, 
16 is the default. 

is a decimal value in increments of 0.25kb 
specifying the largest system space area in 
which system data structures (i.e., file 
control block (FCB), task queue entry (TQE) , 
TCB) of a background task can be stored. If 
this parameter is omitted, 9 is the default. 



Functional Details: 

If this statement is omitted, the default parameters are assumed. 
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CLOCK 



2.2.3 CLOCK Statement 

The CLOCK statement sets the line frequency of the clock and 
device addresses of both the precision interval clock (PIC) and 
line frequency clock (LFC) for the system. Together, these 
clocks are called the universal clock (UCLOCK) module. 



Format: 



(CLOCK [Vj 





fife addr) 



M 



Parameters : 



50 



pic addr 



lfc addr 



is a hexadecimal number indicating the line 
frequency value. If this parameter is 
omitted, 60 is the default. 

is a hexadecimal number specifying the 
physical device address of the PIC. The 
user-specified address must not be greater 
than the maximum device address specified by 
the DEVADS statement. If this parameter is 
omitted, 6C is the default. 

is a hexadecimal number specifying the 
physical device address of the LFC. The 
user-specified address must not be greater 
than the maximum device address specified by 
the DEVADS statement. If this parameter is 
omitted, 6D is the default. 

is the alphabetic character D specifying that 
the date and time are to be displayed on the 
display panel. This parameter should be 
specified only if the central processing unit 
(CPU) statement indicates that the target 
system is a Perkin-Elmer Model 7/32 or 8/32 
processor. 



Functional Details: 

If this statement is omitted, the default parameters are assumed. 
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CMDLEN 



2.2.4 CMDLEN Statement 

The CMDLEN statement specifies the maximum length of the system 
command buffer or buffers if the command substitution system 
(CSS) is supported in the system. 



Format: 



CMDLEN [V| 



u 



Parameter : 



n 



is a decimal number from 32 to 1,024 
specifying the number of bytes in the system's 
command buffers. If this parameter is 
omitted, 80 is the default. 



Functional Details: 

If CSS is supported, or commands are read from devices or files 
with record lengths greater than 80, a larger command buffer 
length must be specified. If CSS is supported, parameter 
substitution causes a small input line length to be expanded to 
a greater length that must be less than or equal to the system 
command buffer length. 

If this statement is omitted, 80 is the default. 
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COORDINATION 



2.2.5 COORDINATION Statement 

The COORDINATION statement establishes the maximum number of 
simultaneous data transfers allowed in the target system. This 
statement must be entered if the number of selector channels 
(SELCHs) is greater than the number of simultaneous data 
transfers allowed in the target system. 



Format : 



COORDINATION [VJ 



&ELCH-= 



(S-| , S 2 ,S n ) 



DEVICE- 



nan^ 



( name! , . . . , name n ) 



,TRANSFER=n 



Parameters: 



SELCH=- 
DEVICE- 



S, - S n specifies the SELCH to be coordinated. 

namei - name n specifies the devices requiring 
coordination. 



TRANSFER- 



n specifies the maximum number of simultaneous 
transfers. If 1 is specified, the resulting 
extended direct memory access (EDMA) node 
functions like a supernode (the main 
coordination node that coordinates the other 
nodes and their attached devices), providing 
coordination only, without impact on the 
transfer rate. Table 2-1 provides recommended 
numbers of simultaneous transfers for the 
various Perkin-Elmer 32-bit processors. 
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TABLE 2-1 RECOMMENDED NUMBER OF SIMULTANEOUS 
DMA TRANSERS 



NUMBER OF | 

TRANSFERS | SYSTEM 

1 | Model 7/32, 3205 


1 | Model 8/32 with one or more 
| nonbuffered SELCHs ; extended 
| SELCH (ESELCH) 

4 | Model 8/32 with buffered SELCH 
| (BSELCH) 


4 | Model 3210, 3220 and 3230 with 
i BSELCH3 


* | Model 3240, 3250 and 3200MPS 



* This value is dependent on the hardware 
configuration. 



Functional Details: 

The COORDINATION statement should be used if the number of SELCHs 
in a system with MSM80 or MSM300 disks or 6250 bits per inch 
(bpi) magnetic tape drives is greater than the number of 
simultaneous data transfers allowed in the system. 



One COORDINATION statement must be entered 
SELCHs or devices requiring coordination. 



for every group of 
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COPY 



2.2.6 COPY Statement 

The COPY statement copies data into the macro 
Statements are copied to the file in the format in 
read until the ENDCOPY statement is encountered in 



output file, 
which they are 
column 1. 



Format : 



COPY 
1 ine.," 

_line n 
ENDCOPY 



Parameter 



line 



specifies data to be 
output file. 



copied into the macro 



Functional Details: 

The COPY statement is useful when a user wants to include 
user-specified macros in the generated macro file. It is 
recommended that the macros that are more commonly called in a 
normal sysgen should be included. 



Example: 



COPY 
MCALL 
MCALL 
MCALL 
MCALL 

ENDCOPY 



DCB I , CCB I , CONVNUM , EVNGEN 
MMDGEN r DCB53,DCB54 
MTRI,DCB65 
BIOCGEN r DCB39 
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CPU 



2.2.7 CPU Statement 

The CPU statement specifies the Perkin-Elmer 32-bit processor for 
which the system is being configured. 



Format: 



CPU DQ 




Parameters: 



3250 specify the target system processor model 

3240 number. If this parameter is omitted, 3220 is 

3230 the default. The Model 3200MPS System is 

3220 valid for the multiprocessor system only. 

3210 

3205 

3200MPS 

8/32 

7/32 

2 are decimal numbers that specify the number of 

8 register sets supported by the hardware. The 

Perkin-Elmer Model 3200MPS, 3205, 3210, 3220, 
3230, 3240, 3250 and 8/32 Systems support 
eight register sets. If this parameter is 
omitted for the Model 7/32 processor, 2 is the 
default. If this parameter is omitted for all 
other processors, 8 is the default. 

Functional Details: 

If this statement is omitted, the default parameters are assumed. 
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! CSS 



2.2.8 CSS Statement 

The CSS statement specifies the maximum number of nested CSS 
calls allowed in one routine for the target system. 

Format : 



CSS [V] 



Parameter: 

n is a decimal number from 1 through 249 

specifying the maximum number of nested CSS 
calls in one routine; i.e., the number of 
routines that can be active at one time. If 
CSS is not supported, 1 must be specified. If 
this parameter is omitted, 5 is the default. 

Functional Details: 

The operating system allocates the amount of memory required for 
a CSS by the following equation: 

MEMORY =■ CMDLEN n * CSS n 

If this statement is omitted, the default is 5. 
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DATE 



2.2.9 DATE Statement 



The DATE statement specifies the format in which the current date 
is expressed for the system. 

Format: 



DATE Q3 



'( DDMMYY}" 

\mmmx). 



Parameters: 



DDMMYY 



is day-month-year format. If this parameter 
is omitted, MMDDYY is the default. 



MMDDYY 



is month-day-year format, 
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DEVADS 



2.2.10 DEVADS Statement 

The DEVADS statement specifies the maximum number of devices, 
maximum device address, maximum number of bytes occupied by the 
interrupt service pointer (ISP) table and the starting address of 
the memory access controller (MAC) or SSTABLE in the system. 

Format: 



DEVADS [V] 




Parameters: 



3 
1 



are decimal numbers specifying a table entry 
containing established maximum values. If 
not specified, is the default. The 
established values specified in the DEVADS 
statement must correspond to the hardware 
configuration. Table 2-2 lists the maximum 
values associated with each DEVADS statement. 



TABLE 2-2 DEVADS STATEMENT VALUES 



' ! I i MAC, MAT 

I i MAXIMUM ! NUMBER OF | OR SST 

ENTRY ! NUMBER OF | DEVICE j BYTES IN j STARTING 

NUMBER j DEVICES | ADDRESS j ISP | ADDRESS 



3 


! *1,023 


1 X'3FF' ! 


2,048 


i X'900' 


1 


i 511 


! X ' IFF ' | 


1,024 


! X'500* 





i 255 


i X ' OFF » j 


512 


i X'300' 



* This number refers to the number of device 
addresses supported by the operating system. 
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DEVICES. . .ENDD \ 



2.2.11 DEV I CES . . . ENDD Statements 

The DEVICES. . .ENDD statements are used to delimit the device 
descriptor statements. Every device to be configured in the 
target system must be defined by a device descriptor statement. 

Each device descriptor statement requires three parameters, the 
device name specification, the device address and the device 
code. These three parameters must be entered in the order 
described. Optional parameters describing other device details 
can be entered in any order. Not all configuration statements 
are supported by the DEVICES .. .ENDD statement. 
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Format: 



DEVICES 

dev name:,dev address, dev dcode 



XA) 

,£LQCK=)XBf 

XC( 

xd) 



CCM=n] 



QCQHSOLE] [ r CQMIROLLER=n] [disc] [DUAL] [eovJ QlLEVEL-n] 



,1NTIMER= 



n 



M 



,±QCLASS= 



wtt&& ktm^mm. 



,IQLIMI 



T J" 1" 



(7LEADCOUNT=n] QLlNESTATUS=n] QM&XERAMES-n] 
( n 



,M&XWRITEBUFF< 



,NCS> 



,MINREADBUFF= 



mm j L 

[7 NOD I S €] [2 NQNSH AREDj 



(7mto= 






,QUXIMER= 



[7£ADC0UNT=n] (7POLLDELAY=n] Q£QLLIMIT=n) 
I7QUEUE=name] [7BEADC0NTR0L=n] QB£CLEN=n] 



,£0LLTIME= 



n 



,£ESP0NSETIME= 



n V 

.IF**, 3J. 
(7SEINDLE=r{| |]SSA=name] 



(7S£REENTIME=rf) Q£ELCH=n] £siZE=ri] 



,T02= 



ill _ 



[7TRANSLATE=name] 



Qusci-ri] QusCO-ri] fuSER=(uparm[}=parameter])] 



tviRT-(startcyl,ncyl)] 
[TXDCOD-n] 



,K&KEUP- 






|7WRiTEC0NTR0L=n] 



ENDD 
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Parameters: 



dev name 



dev address 



dev dcode 



is a 1- to 4-character device mnemonic 

specifying a unique device name. The first 

character must be alphabetic, the remaining 
alphanumer ic . 

is a hexadecimal number specifying the 
physical address of a device. This number 
must not be greater than the maximum device 
address specified in the DEVADS statement. 
For pseudo devices, specify 0. 

is a decimal number ranging from 16 to 254 
specifying the device code. If the system is 
to be configured with devices defined as 
pseudo output devices, spooling must be 
supported. A pseudo device is a virtual 
device that establishes a correlation between 
a user and a physical output device. Each 
pseudo device is logically linked to a 
physical output device so many users or tasks 
can output to the same logical device 
simultaneously. If pseudo device PR1: is 
logically linked to PRT1: and PRT2:, an 
assignment to PR1: will eventually generate 
output on either PRT1: or PRT2:. 

If the pseudo spooling output device is 
chosen, the extended device code (XDCOD**), the 
record length (RECLEN-) and the size (SIZE=) 
parameters can be optionally chosen. 



Example: 



PR1:, 0, 1, XDCOD-114, RECLEN=80, SIZE=56 



*CL0CK= 



CM= 



CONSOLE 
CONTROLLER^ 



XA specifies the A clock. 
XB specifies the B clock. 
XC specifies the C clock. 
XD specifies the D clock. 

n is a hexadecimal number that specifies the 
channel manager device address. This 
parameter specifies a channel manager 
supported device. 

identifies the device as the console device. 



n is a 2-digit hexadecimal 
the controller address. 



number specifying 
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DISC 



DUAL 



EOV 



ILEVEL= 



INTIMER= 



device 
This is 
only. 



specifies OS/32 directory support, 
the default parameter for disk devices 



specifies that dual port option is in 
for mass storage module (MSM) disks. 



effect 



indicates that end of volume (EOV) labels on 
magnetic tapes are to be processed. If this 
parameter is not specified, EOV labels are not 
supported. 

n is a decimal number from to 3 specifying 
the hardware interrupt level of each 
individual device. If this parameter is 
omitted, the global interrupt level (see the 
ILEVEL statement) is assumed for this device. 

n specifies in seconds the input error timer 
used at the supervisor call 15 (SVC15) level. 
The default is 10 seconds. 



IOCLASS= 



IOLIMIT= 



*LEADCOUNT= 



n is a decimal number from to 31 specifying 
the I/O class of each individual device. This 
number must not be greater than the maximum 
number of device or file classes specified in 
the ACCOUNTING statement. If this parameter 
is omitted, the global IOCLASS is assumed. 

n specifies the number of retries that will be 
attempted for an I/O error. The default is 10 
retries . 

n is a decimal number specifying the number of 
leading synchronous characters within a unit 
of data. 



LINESTATUS; 



MAXFRAMES= 



n defines the static line status (SLS) as used 
in zero-bit insertion/deletion (ZBID) data 
link control (ZDLC). This parameter also 
defines the subprotocol that ZDLC will use on 
the communications line. Options include 
normal response mode, asynchronous response 
mode, symmetrical response mode, LAP, LAPB, 
etc. All protocols may not be supported. 

n specifies the maximum number of 
unacknowledged frames that can be outstanding 
in ZDLC. The maximum possible values are 7 
for normal control mode and 127 for extended 
control mode. 



MAXWRITEBUFF^ 



n specifies the maximum number of bytes in 
size for a write buffer that can be received 
or transmitted. The default is 1,024 bytes. 
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MINREADBUFF= 



MTO= 



N2= 



NCS* 



NOD ISC 



n specifies the minimum number of bytes 
required for a read buffer. The default is 64 
bytes . 

n specifies the number of tenths of a second 
that must expire before devices are repolled 
if there were no positive responses to the 
previous polls. If this parameter is not 
specified, devices are not repolled. 

n specifies the N2 count as defined in the 
X.25 specifications and indicates the number 
of times an information frame can be 
retransmitted following a Tl time-out or 
similar error. The default is 10 times. 

n is a hexadecimal number that defines the 
numbered and information control commands that 
can be used on a ZDLC line. The default is 
E8E8. 

specifies no OS/32 directory support for a 
device. 



NONSHARED 



specifies that an existing 
condition for the device should be 



shared-busy 
ignored . 



OUTIMER= 



*PADCOUNT- 



POLLDELAY- 



*POLLIMIT= 



POLLTIME- 



n specifies the output error timer used at the 
SVC15 level. The default is 10 seconds. 

n is a decimal number specifying the length of 
a pad sequence within a unit of data. For 
asynchronous devices, this parameter specifies 
the length of the carriage return (CR)/line 
feed (LF) sequence that is appended at the end 
of the user buffer. For synchronous devices, 
this parameter is for the number of bits (XFF) 
appended to the end of the write transmission. 

n specifies the amount of time certain data 
communication protocols take to go into a 
delay following a nonresponsive polling cycle. 
If this parameter is not specified, there is 
no delay. 

n is a decimal number specifying the limit of 
polling retries allowed on a line. 

n specifies, in seconds, the time allowed for 
a response following the transmission of a 
poll sequence. The default is 30 units of 
100ms (3 seconds). 



QUECJE= 



name is a 1- to 8-character 
string indicating the name of 
disk I/O scheduling routine. 



alphanumeric 
an alternate 
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*READCONTROL= 



n is a hexadecimal or decimal mask specifying 
read control characters. If specified in 
hexadecimal, the value must be preceded by an 
X. Setting bits in this field can enable the 
special character handling required by the 
terminal. Changing this value enables 
specification of special characters that can 
be used for termination of a line, for a line 
delete or for a backspace. See Table 2-3 for 
a description of options. 



TABLE 2-3 SPECIAL ASYNCHRONOUS CHARACTERS 



! TYPE 

I Termina- 
I tion 
1 charac- 
| ters 


i CHARACTER | 

SEBiaBSSSSBItEBIEBiSlSCXS 

i CR ! 
i ETX ! 


ASCI I 
X'OD' 
X'03' 


MEANING 

Carriage return 

End of text 
(CTRL C) 


I READ 
I MASK 

, X'8000' 

X'4000' 


WRITE 
MASK 

X'8000' 

X'4000' 




i EOT ! 


X'04' 


End of transmis- 
sion (CTRL. D) 


X'2000' 


X'2000' 




| User-defined | 




Terminate read/ 
write 


X'0200' 


X'0200' 




I Any enabled | 
I line delete | 
j character j 




Terminate read 
on line delete 


X'0100' 




i Back- 
! space 


! BS | 


X'08' 


Backspace 
(CTRL H) 


X'0080 






i <-- ! 


X'5F' 


Back arrow or 
underscore 
(shift 0) 


X'0040" 






I User-defined | 







X'0010' 




I Line 
| delete 


: # i 

j User-defined | 


23 


Number sign 


X'0108' 
X'0102' 






I NAK or ! 
I CAN j 


15 
18 


NAK (CTRL-U) 
CANCEL (CTRL-X) 


X'0101' 
X'0101' 




I Control 


i DC1, DC2 j 


11,12 


Carousel/pr inter 
(START) 




X'0400' 




1 DC3, DC4 | 


13,14 


Buffer controls 
(STOP) 




X'0400' 
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TABLE 2-3 SPECIAL ASYNCHRONOUS CHARACTERS (Continued) 



TYPE 
Break 



CHARACTER 
BREAK 



ESC 



ASCII 



X'lB' 



MEANING 



Break fulfills 
prepare 

Do not begin a 
write if break 
status is pres- 
ent; return 
break error. 

Allow Escape to 
break write 



READ 
MASK 



WRITE 
MASK 

X'0001' 



X'0010' 



X'0008' 



RECLEN- 



n specifies 
device. 



the physical record length of a 



*RESPONSETIRE= n specifies, in seconds, the amount of 
response time to a nonscreen read. For 
multidrop terminals involving a microcomputer 



response, this 
point-to-point 
response time, 
be longer . 

The defaults are: 



should be a short time. For 
terminals involving human 
the amount of time should 



For device control blocks 
(DCBs) 156 and 157 
For DCB 158 



7FFF seconds 
3 seconds 



SCREENTIME- 



n is a decimal or hexadecimal number 
specifying the amount of time reguired to read 
a full screen of data. This parameter is used 
for error recovery purposes. If the time 
allotted is not large enough, an I/O could 
fail in the middle of a screen read. If too 
much time is allotted, there could be 
excessive error recovery time expended. The 
recommended times are: 



For DCBs 156 and 157 
For DCB 158 



25 seconds 
20 seconds 
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SELCH' 



n is a 2-digit hexadecimal 
the SELCH address. 



number specifying 



SIZE= 
SPINDLE- 

SSA<= 



n specifies the page size for pseudo devices. 

n is a decimal number from to 3 specifying 
the floppy disk spindle number. 

name specifies the secondary station address 
polling address generated for a ZDLC station 
and applies only to stations defined at 
sysgen. Additional stations can be 
dynamically generated later. The recommended 
polling addresses are: 



For DCBs 181 and 
For DCB 186 



183 01 

01 for the first 
station and 03 for 
the second 



T02- 



TRANSLATE = 



n is a hexadecimal number that specifies Tl 
time-out specified in the X.25 protocol. This 
parameter indicates the time that can be 
allotted for a response after transmitting an 
information frame. The default is 30 seconds. 

name specifies a 1- to 8-character 
alphanumeric name of the translation table 
used for the device. 



USCI = 



US CO 



n specifies a hexadecimal 32-bit mask that 
defines the unnumbered protocol commands used 
with the ZDLC protocol. This parameter 
defines the input commands accepted on the 
line. See the USCO parameter for the default 
fields of this parameter. 

n specifies a hexadecimal 32-bit mask that 
defines the unnumbered protocol commands used 
within the ZDLC protocol. This parameter 
defines the output commands that can be sent 
on the line. 



The default for: these fields differs depending 
upon the subprotocol defined by the LINESTATUS 
parameter. 
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Examples: 

Normal response mode, primary, extended 
control: 

UCSO = 00800010 
UCSI = 10884000 



Normal response mode, secondary, extended 
control: 

UCSO = 10884000 
UCSI = 00800010 



Normal response mode, primary, normal 
control: 

UCSO = 00808000 
UCSI - 10884000 



Normal response mode, secondary, normal 
control: 

UCSO = 10884000 
UCSI = 00808000 



Asynchronous response mode, primary, 
extended control: 

UCSO = 00904000 
UCSI = 10884000 



Asynchronous response mode, secondary, 
extended control: 

UCSO =■ 10884000 
UCSI = 00904000 



Asynchronous response mode, primary, 
normal control: 

UCSO <= 10804000 
UCSI = 10884000 



Asynchronous response mode, secondary, 
normal control: 

UCSO = 10884000 
UCSI = 10804000 
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Symmetrical response mode, extended 
control: 

UCSO - 10984000 
DCS I - 10984000 



Symmetrical response mode, normal control; 

UCSO - 10884000 
UCSI = 10884000 



LAP response mode, extended control: 

UCSO - 10984000 
UCSI - 10984000 



LAP response mode, normal control: 

UCSO = 10884000 
UCSI - 10884000 



LAPB response mode, extended control: 

UCSO = 10894000 
UCSI = 10894000 



LAPB response mode, normal control: 

UCSO ■= 11884000 
UCSI - 11884000 



USER** uparm is a user -defined parameter of up to 

seven characters that is defined in the DCB 
macro definition. 

Parameter is a maximum of 30 characters and 
must be preceded by the equal to sign (=■) . 
Multiple user statements are allowed. 

This option allows a user to have Sysgen/32 
pass a user -defined macro parameter to the 
.MAC file. The user parameter is written to 
the macro call first, allowing positional 
parameters to be used. 
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Examples 



TTY1: ,2,16,USER=(MYPARM) 

CAR1: ,3,22,USER=(PARMl=(12,15)) 

CAR2 : , 4 , 22 , USER= ( PARM1 ) , USER= ( PARM2 ) 



VIRT= 



startcyl defines the starting cylinder, 
counting from zero, of the virtual disk 
specified by this device statement. 

ncyl defines the number of cylinders in this 
virtual disk. Values default to decimal 
unless preceded by an X to indicate a 
hexadecimal value. See Section 4.11.2.2 for 
a discussion of virtual disk. 



Example: 



VIRT- (0,323) 
VIRT= (323,250) 
VIRT= (573,250) 



323 cylinders starting 
at cylinder zero 

250 cylinders starting 
at cylinder 323 

250 cylinders starting 
at cylinder 573 

823 = Total cylinders 



NOTE 

This is a reasonable 
MSM300 removable 
cylinders) . 



layout for a 
disk (823 



WAKEUP= 



*WRITECONTROL= 



XDCOD= 



n defines the amount of time in seconds that 
a certain protocol will go into a time delay 
if it has nothing to do. The default is 30 
units of 100ms (3 seconds). 

n is a hexadecimal mask specifying the write 
control character. The value must be preceded 
by an X. By setting bits in this field, the 
user can enable the special character handling 
required by the terminal. 

xdcod is a decimal or hexadecimal half word 
specifying additional configuration informa- 
tion within a device. If a hexadecimal value 
is specified, it must be preceded by an X. 
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This parameter can be used to request full 
bidirectional I/O control (BIOC) support by 
specifying X08 and a clock. A clock is 
selected from the following: 



OA 
OB 
OC 
OD 



A clock 
B c lock 
C clock 
D clock 



Example: 



XDCOD = X080D 



In this example,. X08 specifies full BIOC 
support, and OD specifies the D clock. See 
the OS/32 Operator Reference Manual and the 
Mu It i -Terminal Monitor (MTM) Reference Manual 
for a description of the features of the BIOC 
driver. 



NOTE 

The asterisk (*) preceding some of 
the parameters denotes parameters 
appliceible to data communication 
devices only (see Section 
2.2.11.2) . 

Table 2-4 shows the extended device codes for data communication 
devices. See Table 4-3 for BIOC XDCOD bit descriptions. 
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TABLE 2-4 EXTENDED DEVICE CODES FOR DATA COMMUNICATION 
DEVICES 



BIT 

^ sa =: si K£ at -sa 




1 HEX MASK 

j (DECIMAL VALUE) 

i 8000 


MEANING ! 

i Is master /slave bit (pro- i 
| cessor-to-processor link I 
I only) . I 




| 8000 


(32768) 


I Indicates that this end of j 
| processor-to-processor link | 
I is master. 1 




| 0000 


(0) 


i Indicates that this end of I 
| processor-to-processor link | 
| is slave. 1 


1-3 


J 7000 




| Is reserved; must be zero. ! 


4-5 


i 0C00 




| Are line configuration bits. | 




! 0800 


(2048) 


! Indicates automatic dial-in I 
| or manual dial-out. 1 




| 0400 


(1024) 


I Indicates a leased line. i 




! 0000 


(0) 


I Indicates a directly connected! 
I null modem cable. ! 


6-7 


i 0300 




| Are line protocol bits. 1 




| 0300 


(768) 


| Indicates half -duplex 2-wire. | 




', 0200 


(512) 


| Indicates simplex write.* i 




! 0100 


(256) 


I Indicates simplex read.* i 




| 0000 


(0) 


| Indicates half-duplex I 
i 4-wire.* 1 


8 


| 0080 




j Is explicit connect request 1 
| bit. ~ i 




i 0000 




| Indicates that the system will I 
i do an automatic connect if an j 
| SVC1 read/write request is I 
i issued to a line that is not | 
| connected. Status returned is | 
! 8225. ! 



2-26 



48-037 F00 R02 



TABLE 2-4 EXTENDED DEVICE CODES FOR DATA COMMUNICATION 
DEVICES (Continued) 



BIT | 


(DECIMAL. 


VALUE ) 


i MEANING 


■=="=== = = - 


BmaiiKBtB;ns9Ra 


•««.«. 


saasssssGB&BBtBa-ssasssiGBBiBSBeBawaittsi 


8 ! 
(con't) | 


0000 
0080 


(con 


•t) 


i If the line is disconnected 
i during read/write request, 
1 A0XX status is returned. 
I Next read/write issued will 
I cause system to automatically 
I connect the line. 

I Indicates system will return 
I error A018 if SVC1 read/write 
I request is issued to a line 
i that is not connected. 


.9 i 


0040 






I Is reserved; must be zero. 


10-11 ! 


0030 






j Are clock bits (PAI.S/PASLA 
i only) . 




0030 


(48) 




i Indicates clock D. 




0020 


(32) 




i Indicates clock C. 




0010 


(16) 




i Indicates clock B. 




0000 


(0) 




1 Indicates clock A. 


12.-15 | 


000F 






I Makes up the default option 
j index for Models 1200 and 
1 1250/1251. Must be zero for 
i all other devices. 



Requires adapter, strapped full-duplex 



The common physical record lengths for data communication 
terminals are shown in Table 2-5. 
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TABLE 2-5 PHYSICAL RECORD LENGTHS 
FOR DATA COMMUNICATION 
TERMINALS 



TERMINAL 
Model 550/550B 
Model 1100 VDU 
Model 1200 VDU 
VDU Models 1250/1251 
Model 6100 
Carousel 
M33 TTY 
M35 TTY 

SIGMA 10 terminal 
Remote line printer 




Functional Details: 

Device codes and device addresses determine shared-busy conflicts 
between devices, such as fixed and removable disks in the same 
drive, cassettes and TTY/KP with TTY/RP on the same device. The 
shared-busy conflicts can be overridden by the NONSHARED 
parameter. Only one channel control block (CCB) is created for 
disks with a shared-busy conflict. 

Shared device leafs will be created by specifying the same device 
address for each device sharing a leaf. In the following 
example, each device will share the same device leaf. 



Example: 

CRT1: ,10,39 
CRT2: ,10,39 
CRT3: ,10,39 
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If ILEVEL and IOCLASS statements precede a group of devices, they 
remain in effect until another ILEVEL or IOCLASS statement is 
read. The ILEVEL and IOCLASS parameters in the device statement 
can be used to override the global setting specified in the 
global ILEVEL or IOCLASS statement for a specific device. 

Default values for all standard devices supported by Sysgen/32 
are maintained in the Sysgen/32 Macro Library. These defaults 
represent driver initialization and termination routines, disk 
sizes, device attributes, defaults for communication devices, 
etc. Certain defaults can be overridden by entering the 
appropriate parameter in the device statements. 

2.2.11.1 Coding Examples of Device Statements 

The following examples show the coding of the OS/32 Configuration 
Utility Program (CUP) device statements on the left and the 
Sysgen/32 device statements on the right. 



Examples : 






OS/32 CUP 






STATEMENTS 


SYSGEN/32 


STATEMENTS 


DEVI CES 


DEVICES 




1:F0,0 


DSC1:, C6, 


51, SELCH=F0, CONTR=B6 


2:B6,0 


DSC2 : , C7 , 


50, SELCH=F0, CONTR=B6 


3 DSC1:C6,51,D 


MAGI:, 85, 
IL=1 


65, SELCH-F1, CONTR=0 


* DSC2:C7,50,D 


CON:, 10, 


39, CONSOLE, ILEVEL=2 


ILEVEL 1 


ILEVEL 3 




1:F1,0 


PRT:, 62, 


114 


2:0,0 


VDU1:, 12, 


39 


3 MAGI: 85, 65 


VDU2 : , 14 , 


39 


ILEVEL 2 


ILEVEL 1 




1 CON: 10, 39, C 


MAG2 : , C5 , 


65, SELCH=F2, CONTR-1 


ILEVEL 3 


*NOTE THAT 


THE CONTROLLERS FOR MAGI 




*and MAG2: 


ARE UNIQUE 


1 PRT:62,114 






1 VDU1:12,39 


ENDD 




1 VDU2: 14,39 






ILEVEL 1 






1:F2,0 






2:0,0 






3 MAG2,C5,65 






ENDD 
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2.2.11.2 Configuring Data Communication Devices 

The following sysgen configuration statements can be used to 
configure data communications devices in the system. The 
parameters are explained under the DEVICES. . .ENDD statements in 
Section 2.2.11. 

• Asynchronous communication lines - device code 144 

LINE:, 40, 144, XD=X0830, REA=XE1C9, WRI*XE8Q9, PAD=2 
LIN2:, 42, 144, XD=X0020 

• Remote line printer and letter quality printer - device code 
145 

RPRT:, 90, 145, XD=X0830 

• SIGMA 10 terminal - device code 146 

SOMA:, 100, 146, XD=X0300, REC-80, REA=X8181, PAD=2 

• Nonediting video display unit (VDU) - device code 147 

CRT3:, 50, 147, XD=XFFFF, REC=80, REA=X8181, WRI=X0400, 
PAD=3 

CRT4:, 52, 147 

• Model 1200 and 6100 VDUs - device code 156 

0WL1:, 60, 156, XD=X0830, REC=80, PAD=2 
OWL2:, 62, 156 

• Model 1250 point-to-point VDU - device code 157 

SWL1:, 70, 157 
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• Model 1250 multidrop VDU and Series 7000 8-bit data j 
transfer - device code 157 i 

MULT:, 80, 158, XD=X0000, REC=80, PAD=2 
MUL2:, 82, 158, XD=X0820 

• Binary synchronous communications line on 201 DSA - device 
code 160 

BQL1:, 120, 160, XD=X8000, REO80, PAD-1, LEA=2, 
TR=BECB . TOP 

BQL2:, 122, 160 

• IBM 3780 RJE emulation on 201 DSA - device code 16.1 

BQZ1:, 160, 161, REO80, PAD-1, LEA=2 
BQZ2:, 162, 161 

• IBM 2780 RJE emulation on 201 DSA - device code 162 

Q278:, 170, 162 

• Binary synchronous processor-to-processor link on 201 DSA - 
device code 163 

P2P1:, 200, 163, REC--80, PAD-1, LEA=2 
P2P2:, 202, 163 

• Binary synchronous communications line on quad-synchronous 
adapter (QSA) - device code 168 

BQSL:, 130, 168, XD=X8000, REC=80, PAD-1, LEA=2, 
TR-BEBC.TOP 

BQS2:, 132, 168 
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• IBM 3780 RJE emulation on QSA - device code 169 

SSA:, 170, 169, REC=80, PAD=1, LEA=2 
SSA2:, 172, 169 

• IBM 2780 RJE emulation on QSA - device code 170 

Q378:, 190, 170 

• Binary synchronous processor-to-processor link on QSA - device 
code 17 1 

PQP:, 210, 171 

• 3270 binary synchronous support on QSA - device code 185 

EMT1 : , BA, 18 5 , XDCOD=XlBO0 , PADCOUNT-3 , LEADCOUNT=3 

• DMA I/O subsystem (DIOS) - device code 192 

DIOS:, 100, 192 

DIOS is always configured with a device code of 192. The 
addresses of the devices under the DIOS must have an even 
address in increments of 2. 

• Ethernet Data Link Controller (EDLC) - device code 212 and 213 
The general formats for the Ethernet device statements are: 

rdev name: , address , 212 ,SELCH=m, NONSHARED , CONTROLLER-n 
wdev name : , address , 213 , SELCH=m, NONSHARED, CONTROLLERS 

Wher e : 

rdev name refers to the read device name, 
wdev name refers to the write device name, 
address is identical for both device names. 
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m refers to the SELCH address location. 

n refers to a logical controller number. The 

chosen number must not conflict with any 
physical controller device number or any other 
logical controller number, such as for 
magnetic tape. 

A sample configuration is as follows: 

ETHR : , 68 , 2 12 , SELCH=F0 , NONSHARED , CONTROLLERS 
ETHW: , 68 , 213 , SELCH=FO, NONSHARED, CONTROLLER-0 

Table 2-6 shows the sysgen default parameter values for each 
communication device. 
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TABLE 2-6 SYSGEN DEFAULT PARAMETER VALUES FOR DATA COMMUNICATION DEVICES 



oo 

i 
o 



[ DEVICE | ! READ | WRITE ! PAD i ! LEAD | POL ! SCREEN j RESPONSE j 

I CODE | XDCOD | CONTROL I CONTROL j COUNT | RECLEN j COUNT i LIMIT j TIME ! TIME ! TRANSLATE 


S ! 144 ! X400 ! E1C9 | E809 | - | - ! - ! - ! ! - 1 ASYN.XLT 


N E | 145 ! X400 | - I X410 j 2 j 1 32 | - ! - ! 30 | 300 ! ASYN.XLT 


HI ! 146 | X300 ! X8181 ! - 1 3 j 80 j - ! - I 30 i 300 i ASYN.XLT 


O E | 147 i X400 I X8181 j X400 | 3 ! 80 i - i - I 30 i 300 ! ASYN.XLT 


O " j 156 | - I I - | 2 | 80 i - ! - ! 25 | X7FFF | ASYNCTOP 


S | 157 | - i - ! - j 2 | 80 ! - j - { 25 ! X7FFF ! ASYNCTOP 


! 158 ! - i - I - | 2 | 80 ! - I - ! 20 I 3 j ASYNCTOP 


] 160 | - I - I - ! 1 ! 80 ! 2 i - ! - I - i BEBC.TOP 


S | 161 ! - i - i - | 1 i 80 ! 2 | - i - ! ! BEBC.TOP 


B N D ! 162 ! - i - ! - ! 1 ! 80 I 2 ! - ! - I - I BEBC.TOP 


N H V ! 163 | - ! i - | 1 | 80 ! 2 | - ! - I - ! BEBC.TOP 


R O C | 168 | - i - i - j 1 | 80 | 2 i - I - ! - I BEBC.TOP 


O S j 169 I - I - ! - | 1 | 80 i 2 | - i - i. - ! BEBC.TOP 


S ! 170 | - | - I - | 1 ! 80 | 2 i - ! - I - ! BEBC.TOP 


| 171 j-!-]-jli80|2!-|-i - ! BEBC.TOP 



O 
O 



o 

M 



2.2.11.3 Configuring Zero-Bit Insertion/Deletion (ZBID) Data 
Link Control (ZDLC) Devices 

The following coding examples include ZDLC data communication 
devices in the system. 

• 3270 binary synchronous support on QSA - device code 172 

SPT1: ,BA, 172 , XDCOD=X0400 , IOL=10 , POLLTIME=10 , WAKEUP=10 , 
P ADCOUNT= 3 , LEADCOUNT= 3 

• ZBID on QSA; SVC15 access - device code 176 

ZBD1 : , B8 , 176 , XDCOD=X0300 

• ZBID on QSA; SVC15 access; simplex I/O - device code 177 

ZBD2:,B8,177,XDCOD=X0100 (simplex read) 
ZBD3: ,B9, 177 , XDCOD=X0200 (simplex write) 

• ZBID channel terminal manager (CTM) on QSA; SVC1 access; 
simplex write - device code 178 

ZB4R: ,BA r 178 ,XDCOD=X0100 , POLLIMIT=5 , IOL=5 ,MINREAD=264 , 
LINESTATUS=X00F9 , USC I =XD0884024 

• ZBID CTM on QSA; SVC1 access; simplex read; daughter to device 
code 178 - device code 179 

ZB4W: , BB , 179 , XDCOD=X0200 

• ZBID CTM on QSA; SVC1 access; - device code 180 

ZB ID: , B8 , 180 , XDCOD=X0300 , POLLIMIT-5 , IOL-5 ,MINREAD~264 , 
LINESTATUS-X0099 , UCS I=OCD0884020 

• ZBID CTM on QSA; SVC1 access; simplex write - device code 181 

ZB: ,B8 , 181,XDCOD=X0100 , POLLIMIT=5 , IOL=5 ,MINREAD=264 , 
LINESTATUS=X00F9 , UCS I =XD0884020 
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ZBID CTM on QSA; SVC1 access; simplex read; daughter to device 
code 181 - device code 182 



ZB : , B9 , 182 , XDCOD=X0200 

ZBID CTM on QSA; SVCl access; half -duplex with assembled 
DCT - device code 183 

ZB: ,BA r 183 f ,XDCOD=X0300 , POLLIMIT=5,MINREAD=264 , 

LINESTATUS=X0099 , UCS I -XD0884020 , UCSO=X18900030 , 
NCS=XF8F8 
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2.2.12 DIRECTORY Statement 

The DIRECTORY statement specifies that secondary directory 
support is included in the system. 

Format : 

DIRECTORY 

Functional Details: 

If this statement is omitted, no secondary directory support is 
included. If a disk is marked on with the CDIRECTORY parameter 
specified in the operator MARK command, and the system is built 
with directory support, file search time is reduced. Marked on 
disks require the following additional working storage areas: 

• system space of 64 bytes for access control blocks (ACBs), and 

• a secondary directory buffer with a default buffer size equal 
to 1,024 bytes. The default value can be overridden when the 
disk is marked on. 



See the OS/32 Application Level Programmer Reference Manual for 
detailed information. 
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2.2.13 DISCBLOCK Statement 

The DISCBLOC statement specifies the maximum physical block size 
for data and index blocks for indexed files and nonbuffered 
files. The parameters are interactively independent. If *my are 
omitted, the default values are used. 



Format : 



DISCBLOCK - 



l r MXBLKSZ-< 



, INDEX = 



, SPOOL- 



, UQNBUF 




Parameters 



n 



is a decimal number from 1 to 255 indicating 
the maximum number of 256-byte segments that 
can be specified for data or index blocks in 
an ALLOCATE command or an SVC7 . If this 
parameter is omitted, 4 is the default. This 
parameter is invalid if MXBLKSZ is specified 
because it is another way of specifying 
MXBLKSZ . 



MXBLKSZ= 



is a decimal number from 1 to 255 indicating 
the maximum number of 256-byte segments that 
can be specified for data or index blocks in 
an ALLOCATE command or an SVC7 . If this 
parameter is omitted, 4 is the default. This 
parameter is invalid if the first positional 
parameter, n, is specified. 
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INDEX* 



specifies the default data and indexed blocks 
for INDEX FILES, where bsize is the data block 
size, and isize is the index block size. 
These values are used as defaults in an 



ALLOCATE 
omitted, 
omitted, 
isize are 
MXBLKSZ. 



command and an SVC7 . If bsize is 
the default is 1. if isize is 
the default is l. Both bsize and 
decimal numbers that range from 1 to 



SPOOL= 



specifies the data and indexed blocks for 
SPOOL FILES, where bsize is the data block 
size, and isize is the index block size. 
These values are used as defaults in an 
ALLOCATE command and an SVC7. If bsize is 
omitted, the default is 1. if isize is 
omitted, the default is 1. Both bsize and 
isize are decimal numbers that range from 1 to 
MXBLKSZ. 



NONBUF= 



specifies the data and indexed 
NONBUFFERED FILES, where bsize 
block size, and isize is the index 
These values are used as defau 
ALLOCATE command and an SVC7 . 
omitted, the default is 64. If 
omitted, the default is 3. bsize 
1 to 65,535 and isize ranges 
MZBLKSZ . 



blocks for 
is the data 
block size. 
Its in an 
If bsize is 
isize is 
ranges from 
from 1 to 



Functional Details: 

The values specified at sysgen will serve as system defaults for 
all other commands that allow the user to specify index or data 
block size. if index or data block size is specified via the 
BLOCK command in SPL/32 or the operator command SET BLOCKS, these 

Sr™^ Si2eS override the default block sizes established by 
DISCBLOCK at sysgen. 
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2.2.14 DSYS Statement 

The DSYS statement specifies the default number of kilobytes of 
available dynamic system space. The size of system space can be 
adiusted by the SET SYS operator command after the system is 
built. The following dynamic control blocks are allocated in 
system space: 

• Private file control block (PFCB) 

• File control block (FCB) 

• Task control block (TCB) 

• Task queue element (TQE) 

• Access control block (ACB) 

• Segment description element (SDE) 

• Private segment table (PST) 

Format: 



DS.YS [=£] 



IV 



Parameter 



n 



is a decimal number from 1 to the total number 
of kilobytes of memory. If n is omitted, 25kb 
is the default. 



Functional Details: 

If this statement is omitted, 25kb is the default. 
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ENDC 



2.2.15 ENDC Statement 

The ENDC statement must be the last sysgen statement specified; 
it indicates the end of all sysgen configuration statements. 

Format: 



ENDC 
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2.2.16 ERRORREC Statement 



The ERRORREC statement specifies that error recording support is 
included in the system. 



Format: 

ERRQRBEC [}{] f d , size, per iod 

Parameters: 

fd is the file descriptor of the default error 

recording file. The specified file is 

assigned by the system as the default error 
recording file. 

size is a decimal number from 1 to 32,767 

specifying the maximum number of 256-byte 
records in the default error recording file. 

period is a decimal number from 1 to 1,440 specifying 

the minutes that elapse between memory error 
recording readouts on the Model 3205, 3200MPS, 
3210, 3220, 3230, 3240 and 3250 processors. 
The recommended period is two minutes. 

Functional Details: 

Error recording supports recording of: 

• I/O errors for all processors 

• System errors for all processors 

• Memory errors for Perkin-Elmer Series 3200 processors 

No significant increase in overhead cost is incurred by recording 
I/O and system errors. 
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The Perkin-Elmer Series 3200 processors contain error recording 
memory and an optional error logger. If this statement is 
specified, the hardware error logger is periodically read and the 
data is written to the error recording file for subsequent 
reporting. If this statement is omitted, error recording support 
is not included in the system. 

If this statement is specified when configuring a Perkin-Elmer 
Series 3200 processor in the system, the MCONFIG statement must 
also be included. 
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2.2.17 FLOAT Statement 

The FLOAT statement specifies that floating point 
(software or hardware) is included in the system. 



support 



Format: 



£LOAT H 




Parameters: 



H 



N 



indicates software floating point is supported 
for single precision floating point (SPFP) in 
the first parameter and for double precision 
floating point (DPFP) in the second parameter. 

indicates hardware floating point is supported 
for SPFP in the first parameter and for DPFP 
in the second parameter. 

indicates no floating point is supported. 



Functional Details: 

Software floating point support should be included only in 
systems that do not support hardware floating point. If the 
hardware floating point parameter is not specified for a system 
with hardware floating point, memory is wasted and unpredictable 
results occur after a power fail/restore sequence. SPFP support 
occupies 1.9kb of memory, and DPFP support occupies 2.9kb of 
memory. 

If the FLOAT statement is omitted, H,H is the default for the 
Perkin-Elmer Series 3200 processors, and N,N is the default for 
the Model 7/32 or 8/32 processors. 
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2.2.18 ILEVEL Statement 

The ILEVEL statement specifies the hardware interrupt levels for 
all devices that are specified between this ILEVEL statement and 
another ILEVEL statement or the ENDD statement. 



Format: 



ILEVEL |Vj 




Parameters : 



is a decimal number indicating the fourth and 
lowest interrupt level at which a device can 
interrupt. If this parameter is omitted, is 
the default. 

is a decimal number indicating the third 
interrupt level at which a device can 
interrupt. If this parameter is omitted, is 
the default. 

is a decimal number indicating the second 
interrupt level at which a device can 
interrupt. If this parameter is omitted, is 
the default. 

is a decimal number indicating the first and 
highest interrupt level at which a device can 
interrupt. If this parameter is omitted, is 
the default. 
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Functional Details: 

If multiple I/O interrupt levels are not to be included in the 
system, omission of this statement causes all devices to be 
configured at the highest interrupt level, 0. A group of devices 
configured with the same SELCH or disk controller address must be 
configured at the same interrupt level. Therefore, the ILEVEL 
statement should directly precede the group of devices to be 
configured at a specific interrupt level. 

The ILEVEL parameter in the device statement is used to redefine 
the interrupt level for a particular device without affecting the 
global interrupt level setting. 
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2.2.19 INTERCEPT Statement 

The INTERCEPT statement indicates that SVC interception support 
is to be included in the system. 

Format: 



INTERCEPT 

Functional Details: 

If this statement is omitted, SVC interception is excluded from 
the operating system. 

This is a required parameter for SPL/32 Spooling support and | 
Reliance R05 or higher. j 
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2.2.20 IOCLASS Statement 



The IOCLASS 

associated 

accounting. 



statement specifies the global class 
with a particular device or group of 



setting to be 
devices used for 



Format: 



IOC-LASS [«], 




Parameter 



cc 



is a decimal number from to 31 specifying 
the class associated with devices or files. 
If this statement or the parameters are 
omitted, 0, 1, 2 and 3 are the default 
classes . 



Functional Details: 

A global IOCLASS can be specified or changed by entering the 
IOCLASS statement immediately preceding the device or group of 
devices to be associated with that class. All devices are 
associated with that IOCLASS statement until the next IOCLASS 
statement is entered. 

The IOCLASS parameter in the device statement redefines the I/O 
class of a particular device and does not affect the global I/O 
class setting. 

User-specified I/O classes must be within the range specified by 
the ACCOUNTING statement (see Section 2.2.1). Table 2-7 lists 
the default device and file classes. 
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TABLE 2-7 DEFAULT DEVICE AND FILE 
CLASSES 



CLASS 



DEFAULT 



■ =====* 



:bsc:s«b! 



Logical I/O (indexed files)* 

Physical I/O with SELCH* 
(contiguous files) 

Physical I/O with multiplexor 
channel (VDUs) 

Logical spooled I/O (spooled 
output) 



* The Accounting Facility requires 
classes and 1. 
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2.2.21 I READER Statement 



is 



The IREADER statement specifies that internal reader support 
to be configured in the system. This statement allows a task 
loaded at the system console to send input messages to the 
command processor. 



Format : 

IREADER 

Functional Details: 

If this statement is omitted, internal reader support cannot be 
configured in the system. 

This statement must be used in order to utilize the operator 
IRBUFF command and SVC2 code 14. 
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2.2.22 ITAM Statement 

The ITAM statement indicates that communications support is to be 
included in the system. 

Format : 

_LTAM 

Functional Details: 

Communications support consists of system modules, drivers and 
DCBs, CCBs, etc. The drivers are stored in either the 
communications driver library or extended communications driver 
library. The system modules are stored in the system 
communications library (see Chapter 3). 
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2.2.23 JOURNAL Statement 

The JOURNAL statement specifies the maximum number of journal 
entries for the system. The system journal is a list of data 
entries that records operating system events and is used for 
tracing the cause of a system failure. 



Format : 



JOURNAL H 



Parameter : 



n 



is a decimal number from to 12,999 
specifying the maximum number of journal 
entries. The number is the default. 



Functional Details: 

The amount of memory required for the user -specified number of 
journal entries is calculated as: 



number of bytes for journal «• 20 (n + 8) 



A source assembly of the operating system must be done with 
SGN.JRNL equal to one to include journal code within the 
operating system. 
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2.2.24 LOGLEN Statement 

The LOGLEN statement specifies the maximum number of bytes of 
message buffer size in the system. 

Format : 



LOGLEN 



Parameter : 



n is a decimal number from 32 to 132 specifying 

the maximum number of bytes of message buffer 
size. If this parameter is omitted, 72 is the 
default. 



Functional Details: 

This statement sets the message buffer size for user tasks 
(u-tasks) executing SVC2 code 7 log message calls. If the length 
of the user-specified message is greater than the message buffer 
size, the right -most bytes of the message are truncated. 

When a u-task running under MTM issues an SVC2 code 7 to the 

system console, the user buffer is truncated to LOGLEN. If the 

SVC2 code 7 is directed to the user terminal, LOGLEN has no 
effect. If this statement is omitted, 72 is the default. 
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2.2.25 LPU Statement 



The LPU statement is used to specify that one or more logical 
processing units (LPUs) are to be configured in the system. An 
LPU is used to assign tasks to processors. This statement is 
valid for a Model 3200MPS system only. 



Format: 



LPU 



'{.. "■ 

(maxapo value 



w 



Parameters; 



n 



w 



is a decimal number that specifies the maximum 
number of LPUs that can be configured in the 
system. If this parameter is omitted, the 
default is the value specified in the MAXAPU 
statement (see Section 2.2.26). This ensures 
a one-to-one LPU-to-auxiliary processing unit 
(APU) mapping capability. 



specifies the size of the LPU/APU 
table. This parameter must be 1. 



mapp ing 



Functional Details: 

An LPU is always mapped to an APU task execution queue. Each LPU 
can be mapped to only one APU queue. However, several LPUs can 
be mapped to the same APU queue. 

Each task is assigned an LPU at link time. The LPU assignment 
can be changed by the task itself, by another task or by the 
system operator. The LPU mapping can be disabled or enabled by 
the task itself or by another task. The default is: mapping 
disabled for LPU = and enabled for the rest of the LPUs. 
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2.2.26 MAXAPU Statement 

The MAXAPU statement is used to specify the maximum number of 
APUs to be configured in the system and map these APUs to their 
APU controllers. This configuration statement is valid only for 
a Model 3200MPS System. 



Format : 



MAXAPU 



"APU-! , contr-) 
APU 2 , contr 2 



APU n r contr n 
ENDAPU 



Parameters: 



n 



is a decimal number specifying the maximum 
number of APUs to be configured in the system. 
If this parameter is omitted, the default is 
9. 



APU! . . .APU n 



is the identity of the APU to be configured in 
the system. The only allowable values for 
this parameter are 1 through 9. 



contr r 



is a hexadecimal address specifying the number 
of the APU controller (real-time support 
module (RTSM) digital I/O (DIO)) for APU n. 
This parameter is called an APU controller 
statement . 



Functional Details: 



One APU controller statement must be entered for each APU 
configured in the system. 



to be 
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Example : 



MAXAPU 



APUl,OA 
APU2,50 
APU3,52 



APU9 , 5E 
ENDAPU 



The hexadecimal numbers in this example of the standard 
controller assignment are device addresses. 
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2.2.27 MAXTASK Statement 

The MAXTASK statement specifies the maximum number of tasks 
(including rolled-out tasks) that can be in the system at one 
time. 



Format : 



MAXTASK [j=] 




Parameter : 



n 



is a decimal number from 1 to 252 specifying 
the maximum number of tasks in the system at 
one time. If this parameter is omitted, 32 is 
the default. 



Functional Details: 

If this statement is omitted, 32 is the default. 
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2.2.28 MCONFIG Statement 

The MCONFIG statement must be used if memory error recording is 
desired for a Perkin-Elmer Series 3200 processor. 



Format: 



MCQNEIG £LOCK=nn,SlART=xx,RANGE=yy 

'NQRECORD^ 

, SHARED=<^ KVRECOED) 
.EE.CORD 



,1NTERL=<4 




Parameters 



BLOCK= 



START= 



RANGE - 



INTERL= 



SHARED= 



nn is a decimal number from to 15 specifying 
the area of memory in megabytes for which a 
particular memory controller is strapped. 
Blocks have to be specified in numerically 
ascending order starting with for the lowest 
megabyte address. For Perkin-Elmer Series 
3200 processors, 1Mb is the minimum specified 
amount of memory. 

xx is a decimal number from to 15 specifying 
the starting megabyte address of the block. 
Fractional megabytes should be rounded up to 
the next full megabyte. 

yy is a decimal number from to 16 specifying 
the number of megabytes in the block. For 
processors containing less than 1Mb, specify 
1. 

2 specifies 2-way interleaving. 
4 specifies 4-way interleaving. 
specifies non inter leaving of memory. 

This parameter is optional and if omitted, 
is the default. 

defines the memory block as part of shared 
memory. This parameter is optional. 
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NORECORD 



NVRECORD 



inhibits the processor from reading the error 
logger for the designated block. The block 
configuration is not verified. 

specifies that the processor should read the 
error logger for the designated block. The 
block configuration is not verified. This 
facilitates bringing an error logger readout 
on-line in a multiprocessor configuration 
without destroying valid data in shared 
memory. If this parameter is omitted, the 
designated block is assumed to be in local 
memory. 



RECORD 



specifies that the processor should read the 
error logger for the designated block. The 
block configuration is verified at system 
start-up time. 



Functional Details: 

As part of the system configuration process, the physical memory 
configuration must be defined if memory error recording is 
included in the system. 

In multiprocessor systems with shared memory, only one processor 
should be designated to read the shared memory error logger. 
This prevents the scattering of error logger recordings. 

One MCONFIG statement is required for each group of memory 
controllers that is strapped for a different address range. 
Typically, there is only one group of controllers unless the 
configuration contains shared memory. 

Examples: 

For a Model 3250 processor with 4Mb 2-way interleaved local 
memory : 



MCONF IG BLOCK=0 , START=0 , RANGE=4 , INTERL=2 



For a Model 3220 processor with 3/4Mb local memory: 



MCONF I G BLOCK*0 , START=0 , RANGE= 1 



48-037 F00 R02 



2-59 



For a Model 3240 processor with 3Mb 4-way interleaved local 
memory, 1.5Mb 2-way interleaved shared memory starting at 
Y'500000', and 2Mb noninter leaved shared memory starting at 
Y' 800000' : 

MCONF IG BLOCK=0 , START=0 , RANGE=3 , INTERL=4 

MCONF IG BLOCK=l , START=5 , RANGE=2 , INTERL-2 , SHARED=RECORD 

MCONF IG BLOCK=2 , START=8 , RANGE=2 , SHARED=NORECORD 

For a Model 3230 processor with 3.5Mb local memory and 1.5Mb 
shared memory starting at Y'400000': 

MCONF I G BLOCK=0 , START=0 , RANGE=4 

MCONF IG BL0CK=1 , START=4 , RANGE-2 , SHARED=NVRECORD 

! For a Model 3205 processor with 2Mb local memory: 

| MCONF IG BLOCK>0 f START=0,RANGE=3 
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2.2.29 MEMCHECK Statement 

The MEMCHECK statement indicates that memory diagnostics support 
is included in the system. 

Format: 



MEMCHECK 



Functional Details: 

The memory diagnostics program is executed at initial program 
load (IPL) time. If any bad or unavailable pages exist in memory 
(256-byte pages for Model 7/32, 8/32 and 3220 processors; | 
2,048-byte pages for Model 3210, 3230, 3240, 3250 and 3200MPS | 
processors? 4,096-byte pages for the Model 3205 processor), the | 
operating system marks them as unavailable. Memory can also be 
tested, marked off and marked on by the operator MEMORY command 
if memory diagnostics support is included. 
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2.2.30 MEMORY Statement 

The MEMORY statement specifies the maximum number of kilobytes of 
available local memory for the system. Local memory is a 
contiguous memory area starting at absolute address and 
consists of the: 



• operating system, 

• dynamic system space, 

• reentrant library segments (optional), 

• task common segments (optional) , and 

• pure and impure segments. 

Format: 



MEMORY |VJ 



n 



Parameter : 



n 



is a decimal number specifying the maximum 
number of kilobytes of available local memory. 
The number is in increments of 16 and ranges 
from 256kb to 1,024Kb -for the Model 7/32, 8/32 
and 3220 processors. The maximum number of 
kilobytes of available memory for the Model 
3205 and 3210 processors is 4,096. The 
maximum number of kilobytes available for the 
Model 3230, 3240, 3250 and 3200MPS processors 
is 16,384kb. If this parameter is omitted, 
256 is the default. 



Functional Details: 

If the operating system memory size exceeds the memory size 
specified by n, the error is not detected until a load module is 
created by OS/32 Link. The size of local memory can be changed 
by the operator MEMORY command. If this statement is omitted, 
the default is 256. 
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2.2.30A MIRROR Statement 

The MIRROR statement specifies that mirror disk support is 
included in the system. 

Format: 

MIRROR 



Functional Details: ! 

If this statement is omitted, mirror disk support is not included | 

in the system- If mirror disk support is not included and an ! 

attempt is made to mark on disks with the MIRROR= option of the | 

operator MARK ON command, an error will result. i 



Mirror disk support occupies approximately 12kb of memory. 
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2.2.31 MODULE . . . ENDM Statements 

The MODULE ... ENDM statements substitute a user -written or 
user-modified system module for a Perkin-Elmer standard system 
module. 



Format: 



MODULE 

new module name 1 
new module name 2 

new module name n 
ENDM 



Parameter 



new module 
name 



is a 4-character name, a period and a 
3 -character variation (ffff.xxx) indicating 
the user-written or user-modified module to be 
selected. If the name (ffff) is the same as 
the standard module name, the variation (xxx) 
overrides the variation normally selected at 
sysgen. However, if the name is not the same 
as a standard module name or USER. xxx, an 
error is generated. 
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NOSEC 



2.2.32 NOSEG Statement 

The NOSEG statement specifies that memory segmentation support is 
excluded from the system. 



Format: 
MQSEG 

Functional Details: 

When segmentation support is excluded, tasks that were previously 
established in pure and impure segments cannot be loaded into the 
system. Exclusion of segmentation support causes inefficient use 
of memory through the loss of shared pure segments. If this 
statement is omitted, segmentation support is included. 
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2.2.33 POWERFAIL Statement 

The POWERFAIL statement is used to specify the action to be taken 
after a power failure occurs. 



Format: 



£QWERFAIL [V] 



( AUTO | 



Parameters 



n 



AUTO 



MANUAL 



is a decimal value from to 65,535 specifying 
the number of seconds to wait after a power 
failure has occurred. If n is omitted, the 
default is five seconds. A value of zero 
indicates no wait is to occur. 

is specified so that the system will 
automatically restart without operator 
intervention. If this parameter is omitted, 
MANUAL is the default. 

is specified so that the system will issue the 
following message from the system console: 
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2.2.34 QUEUE Statement 

The QUEUE statement defines the maximum number of entries in 
system queue used to schedule driver operation. 



the 



Format : 



QUEUE H 



n 



f total row*>*£ of 4«vlc*9) 



Parameter 



n 



is a decimal number from 1 to 64,999 
specifying the maximum number of entries in 
the system queue. If this parameter is 
omitted, the total number of devices in the 
system is the default. 



Functional Details: 

The minimum number of entries should be equal to the total number 
of devices (including nodes, channels and controllers), because 
driver termination routines do not check for sufficient room on 
the system queue when adding entries. 



If this statement is omitted, the total number of devices in 
system is the default. 



the 
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2.2.35 ROLL Statement 



The ROLL statement specifies that roll support is included in the 
system. 



Format: 



EOLL H [rvoln] 



Parameter 



rvoln 



is a 1- to 4-character volume name specifying 
the default roll volume. The first character 
of the volume name must be alphabetic, the 
remaining alphanumeric. If this parameter is 
omitted, blanks are generated as the volume 
name. 



Functional Details: 



When roll support is specified, at least one direct access device 
must be included. If this statement is omitted, roll support 
excluded from the system. 



is 
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2.2.36 SLICE Statement 



The SLICE command is used to invoke the time-slice scheduling 
option. 



Format: 



SLICE H [n] 



n 



is zero or a decimal number from 20 to 65,535 
specifying the time-slice, in milliseconds, 
allocated to each task. If n is not 
specified, time-slice scheduling is disabled. 



Functional Details: 

If n is zero, time-slice scheduling is disabled: otherwise, n 
represents the maximum time in milliseconds that any one task can 
remain active if another task of equal priority is ready. The 
time-slice option is initially disabled. 

The SLICE command provides a SET SLICE capability at system 
initialization. This allows time-slice scheduling to be 
activated automatically by the system. The SET SLICE command can 
be used to override the SLICE statement. See the OS/32 Operator 
Reference Manual for the SET SLICE command. 
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2.2.37 SPOOL Statement 

The SPOOL statement specifies that OS/32 Spooler support is 
included in the system. 



Format: 



SPOOL [V| Qspvoln] 



Parameter : 



spvoln 



is a 1- to 4-character volume name specifying 
the spool volume. The first character of the 
volume name must be alphabetic, the remaining 
alphanumeric. If this parameter is omitted, 
blanks are generated as the volume name. 



Functional Detail: 



When spool support is specified, at 
device must be included. If this 
support is excluded from the system, 
used if the SPL32 statement is used. 



least one direct access 

statement is omitted, spool 

The statement cannot be 
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2.2.38 SPL32 Statement 



The SPL32 statement specifies that SPL/32 support is to be 
included in the target system. 



Format: 

S£L32 



Functional Details: 

This statement and the SPOOL statement explained in Section 
2.3.37 are mutually exclusive statements. If this statement is 
entered, the user cannot specify any spooler pseudo devices in 
the DEVICES. . .ENDD statements. 

When this statement is entered, INTERCEPT is automatically 
included in the system. 
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2.2.39 SSTABLE Statement 

The SSTABLE statement specifies the maximum number of shared 
segment table (SST) entries to be reserved in the system. 



Format: 



SSTABLE jVJ 




Parameter : 



n 



is a decimal number from 1 to 8,192 specifying 
the maximum number of SST entries allowed in 
the system. If this parameter is omitted, the 
default is 32.. 



Functional Details: 



The Model 3205, 3210, 3230, 3250,, 3200MPS and 3240 processors use 
an SST. Each SST entry requires eight bytes. Space for the 
table is allocated in 256-byte blocks. If this statement is 
omitted, 32 is the default. 
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2 . 2 . 40 STARTUP - . - ENDS Statements 

The STARTUP ENDS statements define a start-up CSS procedure, 

executed at system start-up- This feature allows FASTCHEK to run 
automatically and loads the necessary tasks to create the system 
environment. 



Format : 

"STARTUP" 

ENDS 

Functional Details: 

The CSS procedure is executed before the SET TIME request is 
issued by the system. If a SET TIME request is issued from the 
start-up CSS, the operating system ENTER DATE AND TIME request is 
not made. 

The CSS commands are stored in memory in packed format. This 
memory is not reused during system operation. A large number of 
start-up CSS routines could affect the amount of memory available 
for task execution, so start-up requests should be as brief as 
possible, making use of such commands as $TRANSFER. 

The BUILD... ENDB and $BUILD. . . $ENDB commands are not allowed in 
a start-up CSS procedure, but are allowed in a CSS called from a 
start-up CSS procedure. 
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Example : 



STARTUP 

SE T 1/02/84,07:59:59 

$J 

MA DSC1: ,ON, ,CD=200 

$T 

$IFNE 

$JOB 

MA DSC1: ,ON,P 

L .BG,FASTCHEK,80 

T .BG 

MA DSC1: ,OFF 

ST , CH=DSC 1 : , L I : CON 

MA DSC1: ,ON, , CD=ALL 

$TERMJOB 

$IFNE 

$WR *** MARK OR CHECK ERROR ON DSC1: *** 
$EX 

$EN 
$EN 

$TR STARTUP 
ENDS 
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2.2.41 TCOM Statement 

The TCOM statement defines and reserves system storage for TCOM 
segments in global memory. Global memory (shared memory) is 
located outside of local memory. Local memory is defined by the 
operator MEMORY command. 



Format: 



TCOM [=] name 1 ,address 1 ,size t [_/ . . ./name n , address n ,sizen] 



Parameters: 



name 



address 



is a TCOM segment name from 1- to 8-characters 
that corresponds to a labeled common segment 
name in a user program. The first character 
of the segment name must be alphabetic, the 
remaining alphanumeric. 

is a hexadecimal number within the ranges 
specified in Table 2-8 specifying the absolute 
address of a TCOM segment located outside 
local memory. The user-specified number is 
rounded down to the nearest 256-byte page 
address . 



size 



is a decimal number in increments of .25kb 
from . 25kb to the maximum amount of global 
memory. 



Functional Details: 

Global memory is located above MTOP, the area specified in the 
operator MEMORY command, and is limited by the physical memory of 
the system. If the address specified is greater than the 
physical memory of the machine, the error is not displayed by 
Sysgen/32. All TCOM segments must be specified in order of 
ascending physical addresses; a maximum of 14 TCOM segments can 
be defined. Overlapping TCOM segments are not allowed. 
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TABLE 2-8 TCOM ADDRESS RANGE 



CPU J 


ADDRESS 


SEGMENT SIZE | 


MODEL | 


RANGE 


(KB) INCREMENT | 


ss=sassa = Ks = 


SBSS«BSB£SSB 


cssmmsmKmsstasrsass. j 


7/32 | 


1-FFF00 


.25 j 


8/32 | 


1-FFF00 


.25 i 


3205 | 


1-3FF000 


4.0 j 


3210 | 


1-3FF800 


2.0 j 


3220 ! 


1-FFF00 


.25 | 


3230 ! 


1-FFF800 


2.0 | 


3240 i 


1-FFF800 


2.0 | 


3250 ! 


1-FFF800 


2.0 j 


3200MPS | 


1-FFF800 


2.0 j 
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2.2.42 TEMP Statement 

The TEMP statement specifies the default volume name to be used 
for temporary (scratch) file support. 

Format: 

TEMP H Qtvoln] 

Parameter : 

tvoln is a 1- to 4-character volume name specifying 

the default temporary volume. The first 
character of the volume name must be 
alphabetic, the remaining alphanumeric. If 
this parameter is omitted, blanks are 
generated as the volume name. 

Functional Details: 

Temporary file support is always included in the system. If this 
statement is omitted, the default temporary volume name is set to 
blanks. Temporary files are allocated at assign time and deleted 
at close time. To exclude temporary file support, a source 
sysgen must be performed. 
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2.2.43 TGD Statement 

The TGD statement specifies that TGD device support is included 
in the system. 



Format: 



T£D 



Functional Details: 

If this statement is omitted, TGD support is excluded. See the 
OS/32 Application Level Programmer Reference Manual. 
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2.2.44 VERSION Statement 

The VERSION statement specifies a user version that is associated 
with a particular operating system sysgen. 

Format: 

YERS I ON Q*] [y vvvvvvv] 

Parameter: 



vvvvvvvv is an 8-character alphanumeric string 

specifying the version of a particular 
operating system sysgen. If this parameter is 
omitted, blanks are generated as the version 
number . 



Functional Details: 

The 8-character version, in addition to the operating system 
revision and update number, is displayed on the system console at 
system initialization time in this format: 



OS 3 2MTr r -uu . vvvvvvvv 



If this statement is omitted, blanks are generated as the 
version. 
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2.2.45 VOLUME Statement 

The VOLUME statement specifies the name of the default system 
volume. 



Format: 



Y.OLUME [=] [volri] 



Parameter: 



voln is a 1- to 4-character volume name specifying 

the default system volume. The first 
character of the volume name must be 
alphabetic, the remaining alphanumeric. If 
this parameter is omitted, blanks are 
generated as the volume name. 

Functional Details: 

After sysgen, the operator can change the volume name through the 
operator VOLUME command. 

If this statement is omitted, blanks are generated as the volume 
name . 
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CHAPTER 3 
LIBRARIES REQUIRED FOR SYSTEM GENERATION (SYSGEN) 



3.1 INTRODUCTION 

The Sysgen/32 process requires standard system libraries, 
general-purpose driver libraries to support the devices listed in 
Chapter 4, and system and Sysgen/32 macro libraries. These 
libraries are required for the macro expansion and link phases of 
the sysgen procedure. Other system libraries that may be 
required by the Sysgen/32 process are system communications 
libraries if communication devices are configured in the 
operating system, and user libraries if user -written devices are 
configured in the operating system. 

OS/32 supports two types of sysgen: 

• Object-level 

• Source-level 

The object-level sysgen enables a user to configure an operating 
system tailored to specific needs by selecting driver and system 
modules provided in the OS/32 package. Assemblies of system 
modules are not required in performing an object-level sysgen. 

The source-level sysgen enables a user to modify the OS/32 system 
modules and drivers. This procedure requires reassembling one or 
more systems and/or driver source modules, replacing existing 
versions of these modules in the system or driver libraries with 
the user-modified modules, and executing the object-level sysgen 
procedure. Section 3.8 presents sample source sysgen procedures. 

3.2 STANDARD LIBRARIES (OPERATING SYSTEM) 

The standard libraries required for the Sysgen/32 process are: 

• The standard system library (SYS. LIB) 

• The standard driver library (DRIVER. LIB) 

• The end of system module (UBOT.OBJ) 

These libraries are used in the link phase of the Sysgen/32 
process and are available in both object and source versions. 
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3.2.1 Standard System Library (SYS. LIB) 

Table 3-1 presents a description of the 
that can be included in a target system. 



source sysgen options 



The source sysgen modules of SYS. LIB are listed in Table 3-2. 
These modules can be altered by the sysgen parameters in the 
sysgen parameter file. Table 3-3 is a list of the source sysgen 
parameters and the amount of memory the desired sysgen option 
occupies . 

Each module has an extension number that corresponds to 
functional variations that support various sysgen options. Table 
3-4 is a list of module variations in SYS. LIB. The standard 
variations provided in SYS. LIB are a subset of possible 
variations. A source-level sysgen can be optionally performed to 
include or eliminate options in a specific module. A 
source-level sysgen can also be optionally performed to eliminate 
specific source-level sysgen options included in all module 
variations. 



TABLE 3-1 SOURCE SYSGEN OPTION DEFINITIONS 



i OPTION | MNEMONIC | DEFINITION I 

j Journal i JRNL i Supports recording of normal internal i 
j support i i system events on a circular list in i 
1 j | memory. Used as a debugging tool for i 
j | | operating system development and is ! 
{ j | recommended for installations where i 
j j | user-written or user-modified modules I 
j ! | are tested. 1 


| Safety check | SAFE | Supports consistency checking within | 
| support i I the operating system. Detected I 
} ! | inconsistencies result in a system ! 
! | i failure. 1 


1 System debug | DBUG 1 Supports debugging of the operating I 
| software | i system. Includes consistency checks i 
i support i ! not intended for operational systems . i 


i Bulk command i BCMD | Supports bulk storage operator i 
i module support | i commands such as WRITE FILEMARK, i 
! j i FORWARD FILEMARK, FORWARD RECORD, i 
j | ! BACKSPACE FILEMARK, BACKSPACE RECORD | 
| | | and REWIND. I 


I Contiguous i CO i Supports contiguous files on direct i 
i file support | | access devices. ! 
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TABLE 3-1 SOURCE SYSGEN OPTION DEFINITIONS (Continued) 



I OPTION ! MNEMONIC | DEFINITION j 

1 — S3 — ssswBBBBLcaBsass: — — ~— -txard 1 *- — a— ssasasesBEssssa*"" wise — — — ■ ■si ea — 1 

I Indexed and j INX | Supports indexed and nonbuffered \ 
I nonbuffered | | indexed files on direct access j 
! indexed file | | devices. ■ 
I support | j ! 


1 Direct access | DA j Supports direct access bulk storage ! 
i device support | j devices (disks) beyond the basic ~ j 
1 i I input/output (I/O) device level, j 
| 1 1 including primary directory support, i 
» ' 1 sector allocation, bit map support | 
! 1 | and volume mechanism support. | 
i 1 | Includes the DISPLAY FILES, DELETE, j 
! ! i XDELETE, VOLUME and MARK operator j 
• i I commands . } 


{ Secondary j DIR | Supports the secondary directory j 
i directory | j feature that provides an in-memory, { 
1 support | j paged index to the disk directory to j 
1 I | reduce access time for directory j 
i 1 j operations. Requires direct access | 
i 1 ! support. j 


1 Mirror j MIRR j Supports the mirrored disk feature, } 
i disk j j which provides a duplicate write to a | 
1 support j j secondary disk drive. Requires | 
1 ! j direct access support. j 


i Spooling j SPOL j Supports OS/32 Spooler. Requires | 
; support | j direct access support. j 


SPL/32 support | SP32 j Supports SPL/32 Spooler. Requires j 

1 | direct access support. j 


Roll support | ROLL | Supports rolling of tasks to disks to | 

I i execute more tasks than can fit into | 
1 j available task memory. Requires | 
I j direct access support. I 


Temporary file | TEMP j Supports temporary files. Requires \ 
support ! j direct access support. j 


Shared | SEG j Supports use of sharable segments | 
segmentation | | such as pure (reentrant) segments, | 
support | j run-time libraries (RTLs) and task j 

1 i commons . j 
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TABLE 3-1 SOURCE SYSGEN OPTION DEFINITIONS (Continued) 



OPTION ! MNEMONIC | DEFINITION i 

Link overlay I AOVL i Supports loading and executing over- i 
support " \ i J aid tasks produced by OS/32 Link. 1 

| i Requires direct access support. I 

Communications j ITAM | Supports communication devices. i 
support | i j 

Trap- I TOD i Supports the 8- line interrupt module, ! 
generating I ! providing task traps in response to i 
device support I i external interrupts. I 

Double preci-' i DF I Supports DPFP in a system without j 
sion floating i ! the hardware to support it. i 
point (DPFP) ! I Includes software emulation routines I 
software | ! for double precision instructions. j 
support: i i [ 

Single preci- i SF ! Supports SPFP in a system without I 
sion floating 1 I the hardware to support it. Includes 1 
point (SPFP) ! 1 software emulation routines for ! 
software ! i single precision instructions. ! 
support I ! ■ 

Seek support | SEEK I Supports C-acan seek scheduling on i 

| | disk devices. Selection of a I 
| j scheduling algorithm is specified in i 
! | each disk device control block (DCB) . | 
| | Standard driver library has seek i 
! j scheduling enabled for all di3ks 1 
j | except floppy. This option is I 
j | required to support those disks. i 
! j Requires direct access support. i 

Extended I EDMA | Supports coordination of multiple i 
direct memory | I EDMA devices. Required if the EDMA I 
access (EDMA) i 1 devices exceed the bandwidth 1 
support I ! capability of the EDMA bus. This I 

j | coordination mechanism is also used | 
| | for floppy disk systems where the I 
i j adapter bandwidth is limited. I 
i j Requires direct access support. i 


Memory i MCHK | Supports memory testing features for | 
diagnostics | i initial system load and at the re- I 
support ! I quest of particular operator com- i 

! j mands. Finds and marks off bad I 
| ! memory. I 
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TABLE 3-1 SOURCE SYSGEN OPTION DEFINITIONS (Continued) 



i OPTION | MNEMONIC | DEFINITION | 

j =«■»--«--«»---*-■«««■■,■,„»«„„„„„«„„„«.„„_„„„____,__ , 

I Memory error | MERC | Supports recording of memory errors \ 
I recording | j generated by the system. Requires j 
i support i ! that general error recording is { 
1 I I selected. Available for the Perkin- j 
i i i Elmer Series 3200 processors. j 


i General error | GERC j Supports error recording of memory, | 
i recording | | i/o, system errors and system mile- j 
I i i stones. } 


I Model 3210, j 3200 | Supports the Perkin-Elmer Series 3200 j 
i 3220, 3230, j j processors. « 
i 3240 and 3250 } j j 
| support | ! i 


I Memory address j ATM | Supports MAT on Model 3210, 3230, j 
i translator | j 3240, 3200MPS, 3205 and 3250 pro- j 
I (MAT) Model j j cessors. Must be removed for Model j 
i 3200MPS, 3205, | | 7/32, 8/32 and 3220 processors. j 
{ 3210, 3230, i j . 
i 3240 and 3250 { j j 
I support | ! i 


I Accounting | ACCT | Supports job accounting of system j 
I facility | j resources. Requires direct access j 
I support | j support. " I 


1 File | ACCF j Generates accounting records for file | 
i accounting j j renames and deletes. Requires | 
I i | accounting support. Requires direct | 
1 1 i access support. j 


i Internal \ IRDR j Supports sending input messages to J 
1 reader | j the command processor by console- | 
1 1 | loaded tasks. > h 


i Auxiliary | APU | Supports the Perkin-Elmer Model j 
! processors | | 3200MPS System. j 
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TABLE 3-2 SYSTEM SOURCE MODULES AND SUPPORTED FEATURES 



oo 

I 
o 

CO 

-J 

O 

o 

» 

o 

to 



SOURCE MODULES ! SUPPORTED FEATURES ! 


! U IS ID IB |C |1 ID ID |M IS IS |R IT IS |A |1 IT ID IS |S IE |M |.M 10 13 |A |A |A |I |A 1 

1 |R |A IB IC |0 IN |A II II IP IP IO IE IE |0 |T |G IF IF |E |D |C IE IE |2 |T |C |C |R |P 1 

j |N IF |U |M I IX I |R |R |3 10 IL |M |G |V |A ID I 1 IE |M |H |R |R 10 |M |C |C ID |U 1 

FUNCTION 1 NAME |L IE |G ID I 1 1 1 |R 12 |L |L IP 1 |L |M 1 I 1 IK |A |K |C |C |0 1 ^.i^,!*,!.. i 

Auxiliary 1 1 1 1 1 1 1 1 i ! ! 1 j j j j j j j j j j J j j j j | j \ [ \ 

Processing! 1 1 1 1 1 I 1 1 1 ! 1 i ' ! > ' ' ' ' ' ' | J | j ! ] J | [ ! 

1 unit (APU)i | | I | I I I 1 ! ! 1 1 1 ! ! 1 ! I 1 j j j ; ; ; ; ; ; ; ; ; 

1 support I APSV.MAC |x |x |x I 1 1 1 1 1 1 1 1 1 1 1 1 1 i i ■ i • ' > • ' ■ ' ' •* \ 


! Console 1 1 1 1 1 1 1 1 1 1 III 1 ! 1 1 1 1 1 1 1 j j j j ■ | | | ! j 
1 Driver 1 CDVR.MAC I 1 1 1 1 1 ! 1 1 1 ! 1 1 i i ' < < '• '< '• ' < ' | 


! Display I 1 1 1 1 1 ! ! ! ! I ■ 1 '< '< ■ 1 '' '• | | j j j j j | | j ! ! 
1 and Bulk I 1 1 1 1 1 ! ! ! 1 I 1 i ! 1 ! ' ! ' ; ' ' ; ; ; ; ; ; ; ; ! 
1 Command I CMDB.MAC I I |x|x| 1 |x]x|x|x|x|x|x| I |x| 1 , 1 ; 


Conmand 1 1 1 1 1 1 1 ! 1 I 1 1 '• '• '• • '• '• '• > '• | | \ j j j j j j j j 
1 Executors 1 CMEX.MAC I |. 1 1 1 1 1 1 |x|x|xl 1 1 1 |x| X, i i . 


| Internal 1 1 1 1 1 1 I ! ! i 1 1 1 '< ' '• '< '• '• '' '• j | j | j j j j j j j 
I Reader 1 CMIR.MAC I 1 1 1 1 1 1 1 1 1 ! 1 ! 1 ! i 1 ■ ' '* ' \ 


| Console I 1 1 1 1 1 1 1 1 I i I i i ' '• '• '• > '< j j j j j j j j J \ ', '. 
I Monitor I CMON.MAC 1 1 1 1 1 1 1 1 1 1 1 i i ! i 1 1 1 • i i i i i • 


I Console 1 1 1 1 1 ! 1 1 1 i i 1 ■ '< '< ' '• j j | j j j J j j j j 1 j ! ', 
I and CSS 1 1 1 1 1 ! ! 1 ! 1 1 1 ! ' ' '• '• '< ' • • '• [ \ \ \ ', \ \ ', ', ', 
1 Super- I III 1 1 ! ! I Si I 1 I 1 '• '• > | \ \ \ \ \ \ ',',',','. ', 1 
1 visor I CMSP.MAC |x I I I 1 1 1 1 Ix 1 1 1 1 1 1 1 x , i i i . i i i i 


1 Error I 1 1 1 1 1 ! i ! ! 1 I '< '< • '< '• '• \ | j j | j | j j j j \ \ ] 
I Recording I ERRC.MAC I 1 j 1 1 1 1 1 1 1 i 1 1 1 ! x,,x,x,,,,,ti 


I Account- 1 1 1 1 1 1 ! ! 1 1 1 1 1 > > ' < ' '< • < \ | j \ j j j j i j 1 

i ing i i :: : i i ! :: i ' ■ ■ • j ■ j ;::::: t :::„:„:: : 

1 Facility 1 EXAC.MAC I I I 1 1 1 ! 1 1 1 1 ! 1 1 ■ • ■ ' x ix , , , 


! Interrupt 1 1 1 ! 1 1 ! ! ! I i I 1 1 i '< '< '< '< j • j j j j j j j j j i i 
1 Handler I EXIN.MAC |xl |x| 1 1 1 1 1 1 1 1 I i |x|xl 1 i i i ,x,x, ,x,x, , , i . 


! I/O I 1 1 1 ! 1 I ! 1 i ! | ; j | | ; j j | ! 1 i, i i 1 i 

| | EXIO.MAC ix Ix I I 1 1 1 1 Ix I I 1 1 1 1 Ix , , i ix ,x , x , , , , 


! Loader I 1 1 1 1 1 1 1 ! I 1 1 i I '• '• '• '< '• ' '• j j | j j j j \ j j 

s and i II II I s l i ! I l l I I > l ' '• '• • !!!!!!!! 1 ! ! 

I Segment I 1 1 1 1 1 1 I I ! 1 1 ! 1 ■ • ' ■ ' ' ' '' ■ j j \ \ \ \ ', \ 
1 Control 1 EXLD.MAC | | | I I 1 1 x I I 1 1 Ix I Ix |x 1 1 1 1 . iX ,x , , , , x , , , , 


1 Memory 1 1 1 1 1 1 S 1 1 1 1 1 1 ' ■ '• ■ • ' 1 ' ■ • ■ • ' | ; J J ,' 
1 Manager 1 EXMY.MAC I |x| 1 1 1 |xl 1 1 1 |xl 1 1 |x| I 1 1 1 1 i . ,x,x, , , , , 


! Super- 1 1 1 1 1 1 i ! ! 1 I I i 1 1 i '■ ! 1 j j \ \ \ j | | j \ \ i ' 

l visor i i i i : : s s ! s i s i i s i • ' ' ; ; ; ; ; : ' : \ \ ', ' 

1 Services j EXSP.MAC |x|||llllillx||lll x , , , , 


! SVC3.4, 1 ! ! i ! ! ! ! 1 1 ! I ! ! i ! i | j j ; j | | | i j | | i i 
I 5,6,7,14 ! EXSV.MAC | | I I 1 1 Ix 1 1 1 1 1 x I Ix I x I Ix I 1 
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TABLE 3-2 SYSTEM SOURCE MODULES AND SUPPORTED FEATURES (Continued) 



1 SOURCE MODULES I SUPPORTED FEATURES 


1 i !J IS ID IB jC jl |D ID jM j3 j8 |R jT |S jfl jl jT |D |S |S IE |M |M |G |3 |A |A |A |I |A 
1 1 |R |A IB |C |0 |N |A |I |I |P |P |0 IE IE |0 jT |G |F |F |E |D |C |E IE |2 |T |C |C |R |P 
1 I IN IF |U |M | |X | |R |R |3 |0 |L |M |G |V |A ID 1 I IE |M |H |R |R |0 |M |C |C |D |U 
1 FUNCTION I NAME |L IE |G ID I j I | |R \2 |L |L IP I |L jM I I I JX |A |X |C |C JO I IT IF |R | , 

'• Timer ! Ill 1 1 1 1 1 1 1 1 | | | | | | | | | | | | | | j j j | j 
1 Manager I EXT I .MAC llx||||||||||||||x|||||||||x||x|||| 


1 Task ' 1 i 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 | | | | | | ; 

1 Manager I EXTM.MAC ix |x I I I | | | | | | |x I |x | | | | | | | | | | | x I | x I | | | 


1 Floating I 1 ! ! ! ! 1 ! 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 I I | | | i 
i Point 1 1 II 1 1 I I I I I | | | | | | I | | | j j j | ■ j | j . | | 
1 Traps I FLTP.MAC 1 1 1 1 I I I I I | | | | | | | | |x |x I | | | | | | | | j | | 


! Conti- I ! ! ! ! ! ! ! 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 I I I I I | ! 
! 9 uous ! Ill 1 II 1 1 1 1 1 1 1 I I I I I I | | | | | | | | | j j j 
1 File ' 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 I | | | ! | | | | ; 

qvrl ' i i i i i i i i i i i i i i i i i 

1 avl - L i ii 1 1 1 1 1 1 1 I 1 I I | | | | | | ! ! 

1 Interrupt I FMCO.MAC I I I I |x | j | jx I | j | | | j j | j j | | | j j • j j > . . 


1 Indexed I i i i ! ! ! 1 I 1 ! 1 ! 1 1 ! 1 ! 1 1 1 1 I i 1 1 1 i I | | | 

i File i : : i i : : i i : i i i i i i i i i i i i i i i i ! i i i i i 
i svcl i i i 1 i i i i i i i i i i i i i i : i i 

1 Interrupt I FMIN.MAC ! i 1 ! i Ix ! i 1 1 ! ! ! i 1 i I ; j j : | j j j ; j j • j j 


1 SVC7 j FMA7.MAC j I I I I x I x j x I j j j x I j x j I j x I I j j j J j j x I j j j | • \ 
1 Interrupt I FMB7.MAC I j | | jx |x |x Ix I I |x I ix j | |x I ; | j | j | |x | j |x |x j | | 
1 1 FMS7.MAC 1 1 1 1 1 ! IX I | | |x | | | | |x I | ! | | | | i ! | i • : ; ; 


! File ! ! 1 1 ! i 1 1 ! 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 I 1 1 I I I I ! 
! Manager j 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 ! 1 1 1 1 1 ! I I | | | | | 
! Utility ! i 1 1 1 1 1 1 1 1 1 1 1 1 ! 1 1 1 ! 1 1 1 1 1 I I ! | | | | | 
! Routine I FMUT.MAC j | |x | | j |x |x | Ix j |x I | | x | | | | ■ | | | | | ; | j j ; ; j 


i Intercept I INTC.MAC ! 1 i i 1 ! ! i i ! I I . S j j | | | i | | j ; | j j ; < ; | ; j 
I Manager I INTO. MAC 1 1 ! 1 1 1 ! i i ! 1 I I I | j | j j | j | ; ; { • • j j ; . 


'• Memory I 1 i i i i ! i i 1 i i i i 1 ! ! ! 1 1 i i i I I i ! I j j ; j 
Diagnos- | III 1 1 1 I 1 I | | | | | | | j j | j j ■ j j j j . . . . , 
tics ! MCHK.MAC 1 1 Ix ! ! I I | | | | | ! | | j j j j ■ | !x . ; | | ! | , , , 


Panic i ! 1 1 1 1 1 1 1 ! 1 1 1 1 1 I 1 1 1 1 1 I I I II! 

Dump | DUMP. MAC 1 ! ! 1 1 I 1 1 1 1 ! ! ! ! ! I | | | | | j | j j | . j j j j 


f™ 3 ° f j 1 1 ! 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 i i 

System 1 i ! i ! i ! 1 1 i 1 1 1 1 1 1 1 1 1 1 1 1 I 1 1 1 I 1 I ! | | 
Modules I UBOT.MAC ! I 1 I I 1 1 1 1 I I I ! 1 1 I I I | | | j j | | ; • > I 1 1 


Communi- | Ill » . j 

cations ■' i i i : i: i i i i i i i i i i i i i i i i i : i i i i i i i 

Support | ITFM.MAC 1 1 1 I 1 1 1 1 1 1 Ill 



supported source module features 



I 



Certain features supported by the system source modules might not 
be desired in the user operating system. Therefore, the user can 
change the features that a source module supports. By choosing 
a module whose value equals 0, support for that feature is 
excluded. To include support for a feature, choose a module 
whose value for the specified sysgen option equals 1. 



Example: 



SGN.SPOL EQU 1 Spooling support included 
SGN.SPOL EQU Spooling support excluded 



Table 3-3 lists the system source modules, source sysgen 
parameters and the approximate amount of memory the desired 
sysgen option occupies. 



TABLE 3-3 DEFINITIONS OF SOURCE SYSGEN PARAMETERS 









APPROXIMATE 


SYSGEN 






MEMORY 


PARAMETERS 




DEFINITION i 


REQUIRED 


======»==»==. 


IBS. 


■■■■■■■■■■■■■■■■(■•■■■■■■■■■■■■■i 


tSBSsasssasssssv 


SGN.JRNL - 





System journal support 
excluded 


N/A 


SGN.JRNL = 


1 


System journal support 
included 


2 . 5kb 


SGN.SAFE • 





Safety check support excluded 


N/A 


SGN.SAFE - 


1 


Safety check support included 


l.Okb 


SGN.DBUG - 





System debug support excluded 


N/A 


SGN.DBUG - 


1 


System debug support included 


2.0kb 


SGN.BCMD = 





Bulk file command support 
excluded 


N/A 


SGN.BCMD => 


1 


Bulk file command support 
included 


; . 5kb 


SGN.CO - 




i Contiguous file support 
i excluded 


! N/A 


SON. CO - 1 




1 Contiguous file support 
I included 


! 1 . Okb 
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TABLE 3-3 DEFINITIONS OF SOURCE SYSGEN PARAMETERS (Continued) 



j i ! APPROXIMATE j 
i SYSGEN j i MEMORY j 
j PARAMETERS j DEFINITION j REQUIRED j 

I SGN.INX = | Indexed and nonbuffered j n/A | 
I | indexed file support excluded j j 

i SGN.INX - 1 J Indexed and nonbuffered j 3 . 8kb j 
! i indexed file support included | j 


i SGN.DIR = | Secondary directory support j N/A \ 
1 j excluded j ■ 

I SGN.DIR = 1 j Secondary directory support | 2 . 5kb j 
1 i included j ! 


I SGN.MIRR = j Mirror disk support excluded | N/A ! 
I SGN.MIRR = 1 | Mirror disk support included | 12.75kb j 


I SGN.SPOL = | Spooling support excluded | N/A | 
! SGN.SPOL « 1 | Spooling support included | 1.25kb | 


! SGN..SP32 - | SPL/32 Spooling support j N/A j 
1 | excluded j i 

I SGN.SP32 = 1 j SPL/32 Spooling support j 1.25kb | 
! ! included j j 


I SGN.ROLL = i Roll- in support excluded j N/A j 
i SGN.ROLL * 1 | Roll- in support included | 3 . Ikb ! 


! SGN.TEMP = | Temporary file support j N/A j 
I j excluded j ' i 

1 SGN.TEMP = 1 | Temporary file support j . 5kb | 
! 1 included j i 


i SGN.SEG = j Sharable segmentation support | N/A | 
1 ! excluded j t 

i SGN.SEG = 1 | Sharable segmentation support | . 5kb | 
i | included j j 


S SGN.AOVL = j Link overlay support excluded j N/A | 
i SGN.AOVL = 1 J Link overlay support included j J.75kb j 
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TABLE 3-3 DEFINITIONS OF SOURCE SYSGEN PARAMETERS (Continued) 



j SYSGEN 
| PARAMETERS 

| SGN.ITAM = 


o : 


DEFINITION i 

Communications support i 
excluded i 


APPROXIMATE | 

MEMORY 1 

REQUIRED ! 

N/A 1 


| SGN.ITAM « 


i i 


Communications support I 
included i 


. 5kb | 


! SGN.TGD - 




Trap-generating device I 
support excluded 1 


N/A ! 


| SGN.TGD = 1 




Trap-generating device i 
support included 1 


0.25kb i 


| SGN.DF - 




DPFP support excluded ! 


N/A I 


j SGN.DF = 1 




DPFP support included 


2 . 9kb ! 


| SGN.SF - 




SPFP support excluded 


N/A ! 


j SGN.SF - 1 




SPFP support included 


1 . 9kb | 


! SGN.SEEK - 





Seek scheduling support 
excluded 


N/A i 


| SGN.SEEK - 


i 


| Seek scheduling support 
| included 


400 bytes i 


| SGN.EDMA = 





| Extended direct memory access 
| support excluded 


| N/A I 


i SGN.EDMA = 


1 


i Extended direct memory access 
| support included 


| 250 bytes | 


! SGN.MCHK = 





i Memory diagnostics support 
i excluded 


! N/A I 


| SGN.MCHK - 


1 


j Memory diagnostics support 
i included 


! 3 . 5kb i 


| SGN.MERC - 





i Memory error recording 
I support excluded 


| N/A I 


| SGN.MERC - 


I 


| Memory error recording 
j support included 


i 3 . 7kb ', 
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TABLE 3-3 DEFINITIONS OF SOURCE SYSGEN PARAMETERS (Continued) 



I SYSGEN 
I PARAMETERS 

! SGN.GERC = 





! DEFINITION 

! General error recording 
! support excluded 


{ APPROXIMATE { 
! MEMORY ! 
j REQUIRED | 

s=asss«sxsxsass j 

1 N/A j 


I SGN.GERC - 


1 


1 General error recording 
! support included 


! 2 . 5kb i 


| SGN.3200 - 





Perkin-Elmer Series 3200 pro- 
! cessors support excluded 


! N/A | 


| SGN.3200 = 


1 


Perkin-Elmer Series 3200 pro- 
cessors support included 


1 . 5kb i 


| SGN.MAT - 





Model 7/32, 8/32 and 3220 
memory management excluded 


N/A | 


i SGN.MAT = 


1 


Model 3205, 3210, 3230, 

3240, 3250 and 3200MPS System 

memory management included 


N/A j 


i SGN.ACCT = 





Accounting support excluded 


N/A j 


I SGN.ACCT - 


1 


Accounting support included 


2 . Okb | 


j SGN.ACCF - 





Delete/rename file accounting 
reporting support excluded 


N/A | 


| SGN.ACCF = 


1 


Delete/rename file accounting 
reporting support included 


0.25kb j 


i SGN.IRDR - 


o 


Internal reader support 
excluded 


N/A 1 


I SGN.IRDR = 


1 ! 


Internal reader support j 
included j 


1.50kb i 


I SGN.APU - 


i 


APU support excluded j 


N/A | 


I SGN.APU - 


1 ! 


APU support included j 


20. Okb ! 
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TABLE 3-4 SYSTEM OBJECT MODULES AND SUPPORTED FEATURES 



oo 
! 

O 
Ca) 
-J 

o 
o 

» 

o 

S3 



SYSTEM OBJECT MODULE I SUPPORTED FEATURES 1 


1 |J IS ID IB |C |I ID ID |M IS IS IR IT |S |A II IT ID IS IS |E |M IM |G 13 |A |A IA II |A I 

! !R |A IB |C |0 IN |A II II IP IP 10 IE |E |0 |T IG IF IF IE ID IC IE IE |2 IT !C |C |R IP 1 

IN IF IU IM 1 IX | |R |R 13 10 11. |M |G IV |A ID 1 1 IE IM IH |R |R 10 IM |C |C ID |U I 

FUNCTION 1 NAME |L IE IG ID 1 1 1 1 |R 12 IL 11. IP 1 II. IM 1 1 1 IK |A IK |C |C ^_,L_iLi--i--i.J 

APU 1 APSV.F01 | | 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 | i 1 '< j '< j j* ' 

support I APSV.F02 ioioioiiiilllllllllllliil!!ii 1!i j*;;:; 


console i I i l l l I l 1 l I l l • 1 i 1 I 1 I 1 I j !!!!!!'! ! 

Driver 1 CDVR.F01 1 I I 1 1 1 1 i i 1 I I ! 1 • I 1 I ' ' ' ' ' ' ' ' ' ' ' ' ; 


1 Display | CMDB.F31 1 |0 |0 11 1 1 !fl JO 10 10 10 10 |0 i 1 1 11 1 1 1 1 1 1 1 1 1 1 1 1 j j 
1 and Bulk 1 CMDB.F32 1 |0 |0 11 i 1 Eii iM ■>! I0I1I1HI 1 111 1 1 1 1 1 1 1 1 1 j ; ; ; ; 
1 Commands 1 CMDB.F33 1 |0 10 11 1 1 fefc;:£l:;!l 11 11 11 11 1 1 IH 1 1 1 1 1 • ■ ■ ; 


Command I 1 1 1 1 1 I 1 1 1 1 1 ! 1 ' ' ' ' ' ' ' ' ' ' ' ; \ [ | | \ \ 
I Executors I CMEX.F33 1 1 1 1 1 1 1 1 Illllll 1 1 1 HI 1 1 1 1 .1 ; 


• ,.,.,,»(, i&M » 

1 Internal 1 CMIR.F01 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 ! ! ! ! ! W4 \ 

1 Reader 1 CMIR.F02 1 1 1 1 1 1 I 1 1 1 1 1 1 1 1 i ■ 1 ' • '< • ' j*|? ; 


1 Console 1 1 1 1 I I 1 1 1 1 1 • 1 • ' 1 1 1 1 1 | j J | | ; | 

1 Monitor 1 CMON.F01 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 i 1 '• ' '• '• • ' > ' ) 


! console I l l 1 l i l ! 1 1 ! < I I « I I ' ■ ' ■ j ; ; ; ; \ ; ; ; ; \ 
1 and css I l l I l 1 l l l 1 ■ I j j j j j ; j ; j ; ; ; ; ' ; ; ; ; ; I 

1 Super- ! 1 1 1 1 1 I I 1 1 i 1 * I ' ' ' J ' \ \ | \ | J J ! 

I visor ! CMSP.F33 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 ' '• > '< ' ' J ' ' ' ! 


! | ERRC.FOI 1 1 1 1 1 1 1 1 1 1 1 1 1 1 ! 1 1 1 i '• '< '< IjJ '^ J ! j j j i j 
! Error 1 ERRC.F02 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 '• ; {* :j * > ; J ; J \ \ 
1 Recording I ERRC.F03 I I 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 ' ' **■ «•» ' ] 


• | EXAC.F01 1 1 1 I 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 | 1 ; ; ffttllli i i 
I Account- | EXAC.F02 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 i > '< '• '■ ; j \ ]~ \ ; | 
1 ing 1 EXAC.F03 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 ' ■ ! ' ' ' ' ' ' x ! l ' ' \ 

i Interrupt 1 EXIN-P51 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 H 1 1 1 1 1 1 1 I i ifP° ;} ■ j ; j 
1 Handler 1 EXIN.F53 1 1 1 I 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 . MgjH .1 ■ • i ; 


i i/o I I I l I l l l 1 l l 1 1 1 I I I j I | ; '• ; | ; ; ; I ; 1 j 
1 Super- 1 EXIO.FII |0 10 | | I 1 1 1 11 1 1 1 1 1 1 1 1 1 1 11 11 ; ; ; ; ; < a ; ; ; 
! visor i 1 I 1 I I I I I 1 1 I I j j j j | 1 j ; ; j | ; • ; Jip? ; ; 

1 | EXIO.P12 |0 10 1 1 1 1 1 1 11 1 1 1 1 1 1 1 1 1 1 H H 1 . ■ . . f*s| i i • 

I loader 1 EXLD.FS0 1 1 1 1 1 1 11 1 1 1 1 ifii? 11 H 1 1 1 1 1 1 HI 1 '• W$ \ [ ] 
1 and | EXID.F51 1 1 1 I 1 1 H 1 1 1 1 MM I 1 U 1 1 1 1 i I H i ' ■ <pS ; | | 
1 Segment 1 EXLD.F52 1 1 ! 1 1 1 11 1 1 1 1 !«»! H 11 1 1 1 1 1 1 HI 1 1 .1 . > ; ; 
1 Control 1 EXIX1.F53 I 1 j 1 1 1 111 1 1 1 [i i Hill 1 1 1 1 1 HI ■ • kp| i ■ ' 

! Memory 1 EXMY.F52 I 10 1 1 1 1 11 1 1 1 1 (Sfl 1 1 HI 1 1 1 i < j j j ?■ j j- | j \ I 
1 Manager 1 EXMY.F53 1 10 1 1 1 1 11 1 i 1 I fife! 1 1 HI 1 1 1 1 1 ■ • .1,1. 1 . i 



00 
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TABLE 3-4 SYSTEM OBJECT MODULES AND SUPPORTED FEATURES (Continued) 



1 SYSTEM OBJECT MODULE | SUPPORTED FEATURES | 


' 1 IJ IS |D IB |C ji ID ID |M IS IS IR |T IS [A II |T |L |B IS IE IH |M |G |3 |A |A |ft |I |A | 
1 1 IR IA |B |C IO |N |A II II IP IP |0 IE |E |0 IT !G IF IF IE ID IC IE IE 12 |T |C |C |R |P | 
1 1 IN IF IU IM 1 IX | |R |R |3 10 II. IM |C IV |A ID 1 1 |E IM |H |R |R |0 IM |C |C |D |U 1 
1 FUNCTION | NAME |I. |E IO ID 1 1 1 | |R |2 |L |I. IP | II. |M | | | |K IA IK |C |C 10 1 IT IF IR 1 1 

1 Super 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 | 1 | | | | | | ;>;»:; 1 1 1 I 
I visor | EXSP.F51 10 1 1 1 I I I I 1 I 1 1 1 I I I | | I | | | | | | | ffi;:^ I 1 1 1 
I Services 1 EXSP.F53 1 1 I I I I I | | | 1 1 | | ; | J J j | j | j » j | jijHj I I 1 I 


1 I EXSV.FOl 1 1 1 1 1 1 illi | | | j||S |1 |0 | |1 | | | | | | | | | | | | | \ 
1 SVC3.4, | EXSV.F52 1 1 1 1 1 1 f3M 1 1 1 i«Sj 11 11 1 111 1 | | | | | | | | | | | | 
1 5,6,9,14 | EXSV.F53 1 1 1 1 1 1 j:t;Sj 1 I 1 i:||| 11 11 1 111 1 1 1 1 1 I I j I j j | j 


1 Timer I EXTI.F01 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 IS J I I I I I | | |0 I I 1 I I [ 
1 Manager I EXTI.F02 I 10 I 1 1 I I 1 1 1 I ! 1 1 1 1 1 J I 1 I I I I I ; 1 1 I I I I 


1 1 EXTM.F50 10 |0 | I I I I I I I j fip's 1 1 1 1 1 1 1 1 1 1 1 fipj 11 I I j j 
1 1 EXTM.F51 10 10 | | | | | | I | | JijHJi 11 1 1 1 1 1 | | | | | pffij 11 1 | 1 1 
1 Task 1 EXTM.F52 10 10 1 1 1 I 1 I 1 1 1 iigjjj 1 1 1 1 1 1 1 I 1 1 1 %&*$ HI i 1 1 
I Manager 1 EXTM.F53 |0 |0 I I | I | | | | | £g£:| 11 1 1 I 1 I 1 1 1 I I $:;£:$} |1 | | | | 

1 Floating I FLTP.F02 1 1 1 I I I I I I I I I | j ; | | %$ %i * \ | | | | ] | | | | j 
1 Point | FL.TP-F03 1 1 1 1 1 1 1 1 1 | | | | | | | | ']. : iijx 1 1 1 1 1 I ' 1 | | ' 
1 Traps | FLTP.F04 I 1 1 1 I 1 1 1 1 i 1 1 1 1 I I I J;4. JT i i 1 I I I I I I I | | 

1 Conti- | 1 1 1 1 SSUl 1 1 1 1 1 1 1 1 1 1 1 1 j 1 1 1 1 1 1 1 1 1 1 | | 
1 guous | 1 1 1 1 i' J 1 I I I I 1 I I 1 I | | | | | I I | | | | | | | ■ 
i File I 1 1 1 1 S ' i 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 I I I I | | | 
1 Manager 1 PMCO.P33 1 1 1 1 fl ! 1 1 1 1 1 1 1 1 1 1 I 1 ! 1 1 1 1 1 1 1 1 1 1 1 1 ! 


I Indexed J 1 1 1 J 1 1 i 1 1 1 I 1 • 1 I I I I 1 1 j I j | i | j | | > > 

i Fiio i i i i i i Sim i i i i i i ; i i i i i i i i i i i i i i i i i 

1 Manager I FMIN.F33 1 1 1 I 1 [1 ! I 1 1 1 1 I I I I | | | | | | | ; 1 | | | | ; | ■ 


: SVC7 i FMA7.F31 1 1 I I & , j | 1 1 1 I I 1 1 I I | | j j j 1 1 | | ■ ■ 
1 Assign/ 1 FMA7.F33 I 1 1 1 [I J3 tl 4 1 1 11 1 11 1 1 11 1 1 1 1 1 1 1 11 1 | 11 11 | | | 
1 Close | FMA7.F34 I I I I I I , fl i 1 1 1 1 1 1 I I : 1 I 1 ; I I 1 1 1 1 1 1 ! 1 ! ! 


1 SVC7 | FMB7.F31 | | | | Bfr $B 1 | 1 1 1 1 1 1 1 | 1 1 1 |0 | | |0 |0 ! | 
1 Alio/Del 1 FMB7.F33 1 1 1 1 '. „," 'A tl 1 1 1 1 1 1 1 1 1 1 I 1 1 1 1 1 1 1 1 1 1 I 1 1 ! ! 


I SVC7 | FMS7.F31 1 1 i I 1 I j6'l| 1 I 1 1 I I 1 1 1 I I | j | j j j j | ; j | | • 
1 Interrupt I FMS7.F33 1 1 1 1 1 1 E;||t 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 I 1 I I | | 


1 File | FMUT.F31 1 1 1 1 1 1 jiHsfPii 1 10 1 10 1 1 111 I | | | j | | | | j | | | ; 
i Manager 1 FMUT.F32 I I 1 I I [;iffi$iSfi .1- . : : . | | | 1 | | | 
1 Utility | FMUT.F33 1 1 10 | | | fl JA I 1 1 1 1 1 1 1 1 H 1 1 1 1 1 1 1 1 1 1 | | | 1 | 


1 Intercep- 1 1 1 1 1 I 1 ! 1 1 1 1 I 1 1 I I 1 1 1 1 1 1 1 I 1 I I I I I | 
1 tion 1 INTC.F01 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 | 1 | | | | | | | | | | | | 
1 Support 1 INTC.F02 1 1 1 1 1 1 1 1 1 1 1 1 | | | | | | | | | | | | | | | | | | j 


I Memory 1 I 1 1 1 I 1 I 1 1 I 1 1 1 1 I 1 I 1 1 1 1 £:-Sit 1 1 I 1 1 1 1 j 
I Diagnos- | MCHK.F01 I 1 1 1 I I 1 1 1 1 1 I I 1 I 1 1 | 1 | | i:B:-: : } I 1 1 1 1 I 1 I 
1 tics | MCHK.F02 I 1 1 I I I I I I I | | I | | | j ; ; j j jjSSj 1 1 1 1 I I I I 


1 Mirror 1 MIRR.F01 1 1 1 1 1 1 1 1 10 1 I I I I I I I I I I | | | | | | | | | j | 
1 Disk 1 MIRR.F02 1 1 1 1 1 1 1 1 1 1 1 1 1 1 | 1 | | | | | | | | | | | | | | | ; 


I Panic 1 1 1 1 ! 1 I I 1 1 1 1 1 1 1 I I 1 1 1 1 I 1 1 1 1 | 1 | I | I 
I Dump j DUMP.F01 1 1 I 1 I I 1 1 1 I 1 1 1 I I 1 1 1 1 I | I | | j | | j { | | 



I 



= feature is not supported 
i «■ feature is supported 

shading = variation 



3.2-2 Standard Driver Library (DRIVER. LIB) 

The standard driver library, DRIVER. LIB, is required in the link 
phase of the Sysgen/32 process. DRIVER. LIB is available in 
object and source versions. The source modules can be modified 
and included in the driver or user library. 

3.3 STANDARD COMMUNICATION LIBRARIES 

There are two standard communication libraries required in the 
link phase of the Sysgen/32 process if communication devices are 
to be configured in the operating system: 

• The standard communications system libraries 

• The standard communications driver libraries 

3.3.1 Standard Communications System Libraries 

Table 3-5 presents the standard communications system libraries. 



TABLE 3-5 STANDARD COMMUNICATIONS 
SYSTEM LIBRARIES 



LIBRARY DESCRIPTION 

Basic communications 
package library 

ZDLC enhancement 
package library 

3270 emulator package 
souce library 



ITBSYS.LIB 



ITESZDLC.LIB j 



ITES327E.LIB 



These libraries are available in object and source versions 
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3.3.2 Standard Communications Driver Libraries 

Table 3-6 presents the standard communications driver libraries. 



TABLE 3-6 STANDARD COMMUNICATIONS DRIVER 
LIBRARIES 



LIBRARY DESCRIPTION 






Basic communications package 
driver library 

ZDLC driver library 

3270 emulator package driver 
library 

Ethernet data link controller 
(EDLC) driver library 



LIBRARY NAME 
ITEDLIB.LIB 

ITEDZDLC.LIB 
ITED327E.LIB 

ITEDETHR.LIB 



3.4 USER-DEFINED LIBRARIES 

If a user-written communication protocol and/or driver is to be 
included in the operating system, it must be included in one of 
the following user-defined libraries: 

• User-defined system library 

• User-defined driver library 

3.4.1 User-Defined System Library 

Table 3-7 presents the user-defined system library provided to 
contain user-written/enhanced system modules. 



TABLE 3-7 USER-DEFINED SYSTEM LIBRARY 

LIBRARY DESCRIPTION j LIBRARY NAME 
User-defined system library | USERSYS.LIB 
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3.4.2 User-Defined Driver Library 

Table 3-8 presents the user -defined driver library provided to 
contain user -written device drivers. 



TABLE 3-8 USER-DEFINED DRIVER LIBRARY 



LIBRARY DESCRIPTION 
User-written drivers 



LIBRARY NAME 



USERDLIB.LIB 



3.4.3 User-Defined Driver Device Control Block (DCB) Macro 
Library 

The DCB macro library provided for user-written drivers is shown 
in Table 3-9. 



TABLE 3-9 USER-DEFINED DRIVER DCB MACRO 
LIBRARY 



LIBRARY DESCRIPTION I LIBRARY NAME 
User-written DCB macros j USERDLIB.MLB 



3.5 MACRO LIBRARIES 

The macro libraries presented in Table 3-10 are required in the 
macro expansion phase of the Sysgen/32 process. The macros that 
comprise the Sysgen/32 macro library are listed and explained in 
Table 3-11. 
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TABLE 3-10 MACRO LIBRARIES 



I LIBRARY 
LIBRARY DESCRIPTION J NAME 

Sysgen/32 macro library | SYSGEN32.MLB 


Macro library containing system | 

structures j SYSSTRUC.MLB 


Basic communication system macro | 
library (required only if communica- | 
tion support is included) | ITMS.MLB 


General driver macro library j DVRM.MLB 


System macro library j SYSMACRO.MLB 


Model 3270 emulator macro library | ITED327E.MLB 



TABLE 3-11 MACROS IN THE SYSGEN/32 MACRO LIBRARY 



MACRO ! 
CALL NAME | FUNCTION 

AND | Used to AND two hex character strings, of up to 
i eight characters, and returns result in %RESLT. 


ANDD i Used to AND two 1-byte characters and returns 
| answer to %Z. 

APBGEN | Generates and initializes the APU processor 
i block. 


BIOCGEN | Initializes the device-dependent part of the DCB 
i for bidirectional input/output control (BIOC) 
I driven CRTs. 


CONVNUM | Converts a decimal number to 2-digit hexadecimal 
I character string. 



CCBI | Generates and intializes the channel control 

I block (CCB) for non-ITAM devices. 

DCBFORM | Includes DCB format with instructions to aid the 

I user in creating DCB macro for user-written 
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TABLE 3-11 MACROS IN THE SYSGEN/32 MACRO LIBRARY (Continued) 



| MACRO ! 1 
| CALL NAME i FUNCTION I 

j DCBI ! Creates the DCBs and intializes the DCB fields | 
I | for non-ITAM devices. 1 


i DCBINIT i Sets all structure copy flags to zero and starts | 
| | the DCB module. I 


i DCBTERM i Terminates the DCB module. 1 


j DCBxxx | User-defined DCB macro. i 


| DCHX | Converts a decimal arithmetic value to hex string I 
| | and returns result in %HXVAL. i 


} DEF i Defines storage or constants? optionally repeats | 
! | the definition the specified number of times. 1 


| DFLIST i Defines a list and generates a label and entry i 
! j based on the parameters passed. i 


i DMT i Generates the device mnemonic table (DMT) . i 
j j Entries are generated using the information in I 
! | the sysgen device statements. 1 


I DMTEND | Generates the end of the DMT. i 


i EVNGEN | Generates device, directory and bit map leaves; | 
j i generates required nodes (coordination, selector | 
j 1 channel (SELCH) , controller). 1 


j FLTPINIT i Generates external entries (EXTRNS) for the 1 
| j appropriate floating point modules depending on | 
| | support specified in the FLOAT configuration i 
J j statement. (The EXTRN for a user-specified I 
| | module is generated by the Sysgen/32 program.) i 
{ | Generates labels and reserves memory for the pro- j 
! | gram status word (PSW) and register save areas. i 


i GENAPBD | Generates and initializes the directory to the i 
j | APU processor blocks. 1 


j HXDC i Used by HXDCP macro to generate decimal strings. j 


i HXDCP i Used to convert hex strings to decimal strings. I 
j j The result is returned in global variable %DCVAL. | 


i ITAMCCB ! Generates and initializes the CCBs for ITAM i 
! | devices. 1 
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TABLE 3-11 MACROS IN THE SYSGEN/32 MACRO LIBRARY (Continued) 



i MACRO i . 
| CALL NAME | FUNCTION j 

j ITDCE | Creates and initializes the Ethernet specific | 
i | portion of the DCB. 1 


I ITDC1 | Creates and initializes the device-dependent | 
I ITDC2 | portion of the DCB for ITAM devices. j 
j ITDC3 | j 


| IVTGEN | Generates the initial value table (IVT) from in- | 
i | formation entered in the configuration input | 
I i file. ~ j 


i LPMTGEN | Generates and initializes the logical processor | 
I | mapping tables. } 


! MMDGEN ! Generates the mass storage media (MSM) or multi- | 
i i media diagnostic (MMD) device-dependent portion j 
i | of the DCB for MSM or MMD disks. j 


1 MTPI | Initializes the additional DCB fields needed for j 
i | magnetic tapes. j 


I SVTGEN j Generates and initializes the system value table, j 


| TTBGEN | Generates and intializes trap blocks for APUs . j 


I USEREND | Used to end user-determined DCBs . j 


i USERINIT j Resets structure copy flags. Allows a copy of the! 
1 | desired DCB structure to be included in the j 
i | user's DCBxxx macro expansion. j 


i $CRDP ! Contains the extended DCB structures for card | 
I I reader /punches. 1 


i SLABEL | Used to create a label and an entry for the j 
I | passed parameter. j 


i SMCONFIG | Defines the memory configuration for Perkin-Elmer | 
I | Series 3200 processors based on the information | 
i i in the MCONFIG statement. | 


! SPDMT j Flags virtual devices in the DMT. j 
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TABLE 3-11 MACROS IN THE SYSGEN/32 MACRO LIBRARY (Continued) 



MACRO | 1 
CALL NAME | FUNCTION ! 

SPTINIT i Defines and initializes the system pointer table i 
| (SPT) ; sets the panic address and system queue I 
i pointer; generates the interrupt service pointer 1 
! table (ISPT), task control blocks (TCBs) and i 
| the TCB table; generates the journal and pointer | 
j stack. Defines and initializes the system I 
| pointers and tables, and reserves memory for I 
i system structure. 1 


STARTUP I Builds the command stream to run at system start- | 
| up using STARTUP ... ENDS statement input. i 


TCOMINIT | Generates and reserves memory for the global task S 
| common segments using TCOM statement input. I 


VMTGEN i Generates a label and reserves space for the i 
i volume mnemonic table (VMT) . I 


$XEVIN | Allows EVN macro to be called in a follow on I 
| program module. i 


$UP i Used by the SPTINIT macro (when generating the I 
$REV i SPT) to update the operating system revision ID. i 



3.6 INCLUDING USER-WRITTEN DRIVERS 

If a nonstandard device is to be included in the operating 
system, it must be defined in the sysgen device statements. The 
user-defined DCB macro library (USERDLIB.MLB) must be specified 
during the macro expand phase. The library containing the 
user-written driver (USERDLIB.LIB) for the device must be 
specified during the link phase of the Sysgen/32 process. 

Use the reserved device codes 240-254 to configure a user-written 
driver in the system. 



Each device configured in the 
macro call written to the 
code; e.g., DCB39, DCB147, 
creates the device DCB 



system gets an appropriate DCBxxx 

.MAC output file (xxx is the device 

DCB245, etc.) The DCBxxx macro 

and external references to the device 



driver (in DRIVER. LIB or USERDLIB.LIB). The user must create the 
DCBxxx macro definition and put it in the user USERDLIB.MLB file. 
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3.6.1 Creating the DCBxxx Macro 

Creating the DCBxxx macro entails a few intermediate steps: 

1. Use MLU32 to get the DCBFORM macro from the SYSGEN32 .MLB file 
to use as the pattern. 

2. Make the appropriate changes noted in DCBFORM to create the 
DCB macro. 

3. Save the file as DCBxxx. MAC. 

4. Use the MLU32 (macro library) utility to add the DCBxxx macro 
definition to your USERDLIB.MLB file. This library will be 
searched by Macro/32 before the SYSGEN32.MLB in the normal 
sysgen process. Use care when creating definitions of macros 
with names identical to macro names in other libraries. 

5. Use COPY/32 or the LIBLDR utility to add the driver code to 
your USERDLIB.LIB file. The USERDLIB.LIB file will be edited 
by OS/32 Link before the standard DRIVER. LIB file 
Therefore, modified Perkin-Elmer drivers that use standard 
Perkin-Elmer device codes can also be placed in USERDLIB.LIB, 
preempting the standard Perkin-Elmer driver. 

6. Perform a sysgen using the standard SYSGEN. CSS. The 
USERDLIB.MLB file will be assigned and the DCBxxx definition 
will be used. 

See the DCBFORM macro in the SYSGEN32.MLB file. 

The following is a sample CSS used to build USERDLIB.MLB. 

XDEL USERDL I B . MLB 

$BUILD USERDLIB.CMD 

ESTAB USERDLIB.MLB 

INCL DCB240.MAC 

INCL DCB241.MAC 

INCL DCB242.MAC 

SAVE * 

END 

$ENDB 

LO .BG r MLU32;TA .BG 

AS 5,USERDLIB.CMD,SR0 

AS 6 , CON : 

ST 

XDEL USERDLIB.CMD 

$EXIT 
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The following is a sample CSS used to build USERDLIB.LIB. 

XAL USERDLIB.LIB, IN r 126 

$BUILD LIBLDR.CMD 

COPY 6,1 

COPY 7 , 1 

COPY 8,1 

END 

ENDB 

LO „BG,LIBLDR; TA .BG 

AS 1, USERDLIB.LIB 

AS 5,LIBLDR.CMD,SRO 

AS 6,USERD240.OBJ,SRO 

AS 7,USERD241.0BJ,SRO 

AS 8,USERD242.0BJ,SRO 

ST 

XDEL LIBLDR.CMD 

$EXIT 

3.7 INCLUDING USER-WRITTEN MODULES 

The Sysgen/32 interface allows a user to include user-written or 
user-modified modules in the system. To include user-written or 
user -modified source modules, follow these steps: 

1. Copy the source sysgen parameters from the appropriate file, 
SYSGEN.MAC, to a back-up file. 

2. Copy the system source module library to a back-up file. 

3. Change the source parameters in SYSGEN.MAC to include or 
exclude the desired options. 

4 If the name of the modified module differs from the original 
module name, the PROG, ENTRY and EQUATE statement labels must 
be changed to the modified module name. The $OSPROG macro 
can be used to change the original module name to the 
modified module name. 

5. The following assignments must be made to expand the internal 
operating system macros using the Common Assembly Language 
(CAL) Macro/32 processor: 

AL usermodule . EXP , IN , 80 

L .BG,MACR032 

T .BG 

AS 1, usermodule. CAL 

AS 2, usermodule. EXP 

AS 3, NULL: 

AS 8,SYSSTRUC.MLB,SRO 

AS 9,SYSMACRO.MLB,SRO 

AS 10, ITMS.MLB,SRO 

ST ,ML=(8,9,10),MLIST=(ND,NG) 
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To assemble module EXSV, logical unit 11 (lull) must be assigned 
to SYSMAC32.MLB. To assemble module FMS7, lull must be assigned 
to SYSMAC32.MLB r and lul2 must be assigned to DVRM.MLB. 

NOTE 

If user-written macros are to be included 
in the expansion, assign lull to the 
appropriate macro library and start 
Macro/32 by entering:: 

ST ,ML=(8,9,10, 11) ,MLIST=(ND,NG) 

When assembling a driver from the general 
purpose driver library, assign lull to 
DVRM.MLB and start Macro/32 by entering: 

ST ,ML=(8,9,10,1I) ,MLIST=(ND,NG) 

6. Assemble the modified source module using CAL/32 with the 
CROSS and SQUEZ options specified. (The SQUEZ option is 
required to assemble the floating point module.) 

AL usermodule.OBJ, IN, 126 

L .BG,CAL32,55 

T .BG 

AS l,usermodule.EXP 

AS 2, usermodule.OBJ 

AS 3, PR: 

TE 5, EC 

AS 7,SYSGEN.MAC,SRO 

ST ,CROSS,ERS,SQUEZ=99 
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7. Use the following LIBLDR commands to create the USERSYS.LIB. 

LO .BG f LIBLDR 

TA .BG 

AL newsys.LIB, IN, 126 

AS 0,NULL: 

AS 1, USERSYS.LIB 

AS 2, NEWSYS.LIB 

AS 3, CON: 

AS 4, user mod. OB J 

AS 5, CON: 

ST 

.BG>TAB 1,3 

.BG>RW 1 

.BG>TAB 4,3 

.BG>RW 4 

.BG>DUPE 1,2 sysmod.nnn 

.BG>COPY 4,2 

.BG>COPY 1,0 

.BG>DUPE 1,2 

.BG>RW 2 

.BG>TAB 2,3 

.BOEND 

8. Perform a sysgen using the modified user system library. 
Include the MODULE ... ENDM statements to include the modified 
module if the module name changed. 

3.8 SOURCE-LEVEL SYSTEM GENERATION (SYSGEN) EXAMPLE 

To include the code to allow JOURNAL support in the operating 
system, the system source module EXSP.MAC must be reassembled by 
following these steps: 

1. See Table 3-4 for the source module EXSP.MAC affected by the 
sysgen variable SGN.JRNL. 

2. Make a back-up copy of the EXSP.MAC file. 

3. Change the option variables in the SYSGEN. MAC file to: 

SGN.JRNL EQU 1 

This will include JOURNAL support. If the system is a Model 
7/32, 8/32 or 3220, SGN.ATM must also be set to zero. 
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4. Use the EDIT commands to change the source sysqen options in 
the SYSGEN.MAC file. 

LO .BG,EDIT32 

TA .BG 

ST 

.BG>GET SYSGEN.MAC 

.BG>T /SGN.JRNL/ 

8 SGN.ITAM EQU 
.BG>CH / 0/,/ 1/ 

8/ SGN.JRNL EQU 1 
.BG>SAVE NEWSGN.MAC 
.BG>END 

5. Make the following assignments to expand the internal 
operating system macros using the CAL Macro/32 processor. 

LO .BG,MACRO32,20 

TA .BG 

AL EXSP.EXP, IN, 80/4 

AS 1,NEWEXSP.MAC 

AS 2, EXSP.EXP 

AS 3, NULL: 

AS 8,SYSSTRUC.MLB,SRO 

AS 9 , SYSMACRO . MLB , SRO 

AS 10, I TMS. MLB, SRO 

ST ,ML=(8,9,10) 

6. Assemble the user-modified EXIN.EXP module using CAL/32. 

AL EXSP.OBJ, IN, 126 

LO .BG,CAL32,55 

TA .BG 

AS 1, EXSP.EXP 

AS 2, EXSP.OBJ 

AS 3, PR: 

TEMP 5, EC 

AS , 7NEWSGN . MAC , SRO 

ST , CROSS, SQUEZ=99,ERS 

7. Include the new object module, the user system library. 
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8. Perform a sysgen using the modified system library. 



REM 


USERS YS .LIB, USERS YS . OLD 


AL 


USERSYS.LIB, IN, 126 


LO 


.BG 


,LIBLDR; TA .BG 


AS 


0,NULL 


AS 


1 , USERSYS . OLD , SRO 


AS 


2, USERSYS.LIB 


AS 


5 , CON : 


AS 


6,EXSP.OBJ,SRO 


ST 






.BG> 


DUPE 


1,2 EXSP.F53 


.BG> 


COPY 


6,2 


.BG> 


COPY 


1,0 


.BG> 


DUPE 


1,2 


.BG> 


RW 


2 


-BG> 


TAB 


2,5 


.BG> 


END 
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CHAPTER 4 
STANDARD OS/32-SUPPORTED DEVICES 



4.1 INTRODUCTION 



OS/32-supported d 
in this chapter 
System Generation 
is included in 
supported by user 
and must also be 
in the system. S 
user-written modu 



evices and device characteristics are des 

These characteristics must be defined 
/32 (Sysgen/32) device statements when a 
the operating system. Nonstandard d 
written drivers must use reserved device 
defined in the device statements to be in 
ee Chapter 3 for information on conf i 
les and drivers in the system. 



cr ibed 
in the 
device 
evices 
codes 
eluded 
gur ing 



4.2 OS/32-SUPPORTED LOCAL AND REMOTE DEVICES 

Table 4-1 lists, by local and remote device codes, the 
OS/32-supported devices. Table 4-2 lists the categories (card 
reader/punch, local video display unit (VDU) , etc.) of 
OS/32-supported devices and their local and remote device codes. 



TABLE 4-1 DEVICE CODES FOR OS/3 2 -SUPPORTED DEVICES 



LOCAL 


REMOTE 








DEVICE 


DEVICE 








CODE 


CODE 


DEVICE 


TYPE 


INTERFACE 


0-15 




Reserved 






16 




Model 33 Teletype 
board/printer 


(TTY) key- 


CLI 


17 




Model 3 5 TTY keyb 


oard/pr inter 


CLI 


18 




Nonediting VDU 




CLI , CLCM 
RS-232C 


19-20 




Reserved 






21 




Carousel 15, 30, 
character line 


35, 80- 


CLI 


22 




Carousel 2 5, 30, 
character line 


35, 132- 


CLI 


23 




Model 1100 VDU 




CLI , CLCM 


24-33 




Reserved 






34 


147 


Nonediting VDU, 2 


- or 8-line 


RS-232C, 
CLCM, CLI 



48-037 F00 R02 



4 1 



TABLE 4-1 DEVICE CODES FOR OS/32-SUPPORTED DEVICES (Continued) 



CfcT^j 



t?* 8 ' 



LOCAL | 


REMOTE 


DEVICE ! 


DEVICE 


CODE ! 


CODE 






35 ! 




36 i 


147 


37 | 


147 


38 ! 


147 


—P 39 ! 





40 

41 
42 
43 

44 
45 
46 
47 
48 
49 

'50 
-51 
52 
53 
54 
55 
56 
57 
58 
59 

60 
61 
62. 
63 
64 
65 
66 
67 
68 
69 



70 



DEVICE TYPE 

Reserved 

Graphic display terminal (GDT) , 

2- or 8-line 

Carousel 300, 2- or 8-line 

Carousel 300 with electronic 
forms control, 2- or 8-line 
Models 550, 1100 and 6100 VDU, 
2- or 8-line 

Line printer bidirectional 

input/output control (BIOC) 

Reserved 

50Mb CDD50 fixed portion (25Mb) 

50Mb CDD50, removable portion 

(25Mb) 

256Mb disk, fixed 

1.5Mb head per track (HPT) 

160Mb, fixed 

1 . 5HPT 

2.5Mb disk, fixed 

2.5Mb disk, removable 

5Mb disk, fixed 
5Mb disk, removable 
40Mb disk, removable 
67Mb disk, removable 
256Mb disk, removable 
Floppy disk 
68.5Mb disk, fixed 
1.5Mb HPT 
67Mb disk, fixed 
16Mb disk, removable 

16Mb disk, fixed 

48Mb disk, fixed 

80Mb disk, fixed 

675Mb disk, fixed 

800 mag tape 

800/1600 mag tape 

Intertape cassette 

Reserved 

6250/1600/800 STC mag tape 

6250/1600/800 STC mag tape 

(half word mode) 

6250/1600/800 TELEX mag 
tape (half word mode) 



INTERFACE 



;3SKSSS«&3 



RS-232C, 
CLCM 
RS-232C, 
CLCM, CLI 
RS-232C, 
CLCM, CLI 
RS-232C, 
CLCM, CLI 
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TABLE 4-1 DEVICE CODES FOR OS/32-SUPPORTED DEVICES (Continued) 



LOCAL 
DEVICE 
CODE 



71-79 
80 

81 
82 
83 

84 



85-95 


96 


97 


98 


99-103 


104 


105 


106 



107-111 
112 
113 
114 

115-127 
128 
129 

130-135 
136 

137 

138 

139 

140 
1.41-142 

143 



REMOTE 

DEVICE 

CODE 



DEVICE TYPE 



INTERFACE 



; = ?=5as:=s;5=it3t«i , a:t=K;iaEis5': 



IBSttSBf 



Reserved 

High-speed paper tape reader/ 

punch 

Model 33 TTY reader/punch 

Model 3 5 TTY reader/punch 

Carousel 35 with paper tape 

reader, 80- character line 

Carousel 35 card reader, 132- 

character line 

Reserved 

Card reader with software 
translate, 029 card encoding 
Card reader with hardware 
translate, 029 card encoding 
Card reader with software 
translate, 026 card encoding 

Reserved 

Card reader, high-speed, 029 

card encoding 

Card reader /punch, 029 card 

encoding 

Card reader/punch with print 

option separate, 029 card 

encoding 

Reserved 

Low- speed line printer 
Medium- speed line printer 
High-speed line printer 

Reserved 

8-line interrupt module 

Digital (MUX) controller 

Reserved 

Real-time analog system with 

internal clock 

Real-time cinalog system with 

user-supplied external clock 

Mini input/output (I/O) 

analog input 

Mini I/O analog output 

Mini I/O digital 

Reserved 

I/O bus switch 



CLI 
CLI 
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TABLE 4-1 DEVICE CODES FOR OS/3 2 -SUPPORTED DEVICES (Continued) 



i LOCAL | 


REMOTE | 






1 DEVICE J 


DEVICE ! 






| CODE i 


CODE ! 


DEVICE TYPE | 


INTERFACE 




144 ! 


Asynchronous communications i 


RS-232C, 






1 ine ! 


MPC , CLCM 




145 


Remote line printer (ITAM) 1 
and letter quality printer j 






146 


SIGMA 10 terminal (communica- 
tions) 




1 18 


147 


Nonediting VDU (communications) 


RS-232C, 
MPC , CLCM 




148-155 


Reserved 






156 


Model 1200 VDU (communications) 


RS-232C, 
MPC , CLCM 




157 


Model 1250 point-to-point VDU; 
Series 7000 8-bit data transfer 






158 


Model 1250 multidrop VDU 


RS-232C, 
MPC, CLCM 




159 


Reserved 






160 


Binary synchronous communica- 


RS-232C, 






tions line on 201 DSA 


MPC , CLCM 




161 


IBM 3780 remote job entry 
(RJE) emulation on 201 DSA 






162 


IBM 2780 RJE emulation on 
201 DSA 






163 


Binary synchronous processor- 
to-processor link on 201 DSA 






164-167 


Reserved 






168 


Binary synchronous communica- 


QSA,SSA f 






tions line on quad-synchronous 


MPC 






adapter (QSA) 






169 


IBM 3780 RJE emulation on QSA 






170 


IBM 2780 RJE emulation on QSA 






i 171 


Binary synchronous processor- 
to-processor link on QSA 






172 


Binary synchronous IBM 3270 
support on QSA 






! 173-175 


Reserved 






! 176 


ZBID line driver on QSA; super- 
visor call 15 (SVC15) access 
only; half-duplex 






! 177 


i ZBID line driver on QSA; SVC15 
j access only; simplex I/O 






! 178 


i ZBID CTM on QSA; two-way sim- 


! QSA,SSA, 






I ultaneous (TWS) operational 


! MPC 






1 mode; SVC1 access only; simplex 








i input; "mother" to device 179 
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TABLE 4-1 DEVICE CODES FOR OS/3 2-SUPPORTED DEVICES (Continued) 



LOCAL 
DEVICE 
CODE 



REMOTE 

DEVICE 

CODE 

S SB S& XX SB 9S£ ^S 3 

179 



180 



181 



182 



183 



184 
185 

186 



187 



188-191 


Reser 


192 


Direc 




I/O s 


193-211 


Reser 


212 


Ether 




contr 




simpl 




be us 




side) 


213 


Ether 




contr 




simpl 




(must 




read 



DEVICE TYPE 

Zero-bit insertion/deletion 
(ZBID) channel terminal manager 
(CTM) on QSA; TWS operational 
mode; SVC1 access only; simplex 
output; "daughter" to device 178 

ZBID CTM on QSA; TWA opera- 
tional mode; SVC1 access 
only; half-duplex 
ZBID CTM on QSA; TWS opera- 
tional mode; SVC1 access 
only; simplex input; "mother" 
(with assembled DCT) to 
device 182 

ZBID CTM on QSA; TWS opera- 
tional mode; SVC1 access 
only; simplex output; 
"daughter" to device 181 
ZBID CTM on QSA; TWA opera- 
tional mode; SVC1 access 
only; half -duplex; with 
assembled DCT 
Reserved 

Binary synchronous IBM 3270 
emulation on QSA 
ZBID CTM for X.25 level 3 on 
QSA; TWS operational mode; 
SVC1 access only; simplex 
input; "mother" to device 187 
ZBID CTM for X.25 level 3 on 
QSA; TWS operational mode; SVC1 
access only; simplex output; 
"daughter" to device 186 



:ved 

:t memory access 

subsystem (DIOS) 

:ved 

met line driver on Ethernet 

roller; SVC15 access only; 

Lex input; read side (musb 

sed together with write 

:net line driver on Ethernet 
roller; SVC15 access only; 
Lex output; write side 

be used together with 
side) 



INTERFACE 

QSA,SSA, 
MPC 



QSA, SSA, 
MPC 



QSA,SSA, 

MPC 



QSA , SSA , 
MPC 



QSA, SSA, 
MPC 



EDLC 



EDLC 
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TABLE 4-1 DEVICE CODES FOR OS/ 3 2 -SUPPORTED DEVICES (Continued) 



LOCAL 
DEVICE 
CODE 



REMOTE 

DEVICE 

CODE 

214-223 

224-239 

240-254 
255 



DEVICE TYPE 

Reserved 

Reserved for CAMAC access 
method 

Reserved for user-written 

drivers 

Null device 



INTERFACE 



CLI 

CLCM 

RS-232C 



QSA 
SSA 
MPC 
EDLC 



interface 

communications multiplexor 
asynchronous line system (PALS), 
asynchronous 3 ingle line adapter 
COMM MUX 

Quad-synchronous adapter 

Single synchronous adapter 

Multiper ipheral controller 

Ethernet data link controller 



Current loop 
Current loop 
programmable 
programmable 
2- or 8-line 



(PASLA) 



NOTES 

1. CLI is equivalent to TTY interface. 

2. Device code 145 now supports the 
remote serial line printer (ITAM) and 
the letter quality printer. 

3. Device codes 34 and 36 through 40 can 
be utilized to invoke the BIOC driver 
and can be used for local or dial- in 
applications. The BIOC driver 
supports vertical forms control 
(VFC) . 



Full VFC read and write 
are supported by the BIOC 
line printer driver 
point-to-point terminal 



operations 

dr iver , the 

and the 

manager . 



However, the point-to-point terminal 
manager supports VFC in 
conversational mode only. 
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5. The TTY driver and the asynchronous 
terminal manager will not support VFC 
read or write operations. However, 
the affected software (TTY and 
asynchronous terminal manager) is 
modified to treat a VFC write 
operation as if a formatted write 
operation had been received. The VFC 
character will be ignored rather than 
intepreted or printed. 

6. The Model 3270 communication devices 
are not part of the standard 
Perkin-Elmer operating system. To 
have Model 3270 support in the target 
system, the modules must be ordered 
from a Perkin-Elmer sales office. If 
Model 3270 devices are configured for 
the standard operating system, their 
specification will result in 
undefined symbols at link time. 
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TABLE 4-2 CATEGORIES OF OS/3 2 -SUP PORTED DEVICES 



! ! i LOCAL i REMOTE { 
| j | DEVICE ! DEVICE | 
j TYPE i DEVICE i CODE I CODE ! 

! Card reader j With software translate, j | i 
! I 029 card encoding i 96 | I 


! i With hardware translate, | i 1 
j I 029 card encoding I 97 i I 


j i With software translate, i j i 
1 I 026 card encoding I 98 I 1 


1 j Carousel 35 reader j 84 | I 


! Card reader/ I High-speed, 029 card ! j ! 
j punch i encoding I 104 ! 1 


| i 029 card encoding i 105 i i 

j | With print option i i 1 
| i separate, 029 card j I I 
| | encoding I 106 j 1 


| TTY reader/ ! Model 33 (CLI) | 81 i ! 


! * | Model 35 (CLI) i 82 | i 

j j Carousel 35 with paper | I i 
| I tape reader, i 1 1 
i i 80-character line j 83 i 1 


I I Carousel 35 card reader, i i ! 
j | 132-character line I 84 j i 

| TTY keyboard i Model 33 (CLI) i 16 | ! 


| ! Model 3 5 (CLI) i 17 j | 


| ! Nonediting VDU (CLI) | 18 i i 


| | Carousel 15, 30, 35, | ! i 
| | 80-character line (CLI) | 21 | ! 


| i Carousel 15, 30, 35, | i I 
i i 132-character line (CLI) | 22 i i 


| | Model 1100 VDU (CLI) i 23 j I 

! High-speed | ill 
i paper tape | ill 
i reader/punch | High-speed I 80 | ! 
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TABLE 4-2 CATEGORIES OF OS/32-SUPPORTED DEVICES (Continued) 



| TYPE 

! ss. 3s as sac si «, as m m as am sb sac as se a 

| Line printer 
! (ITAM) and 
I letter quality 
I printer 


I DEVICE | 
| Low-speed | 


LOCAL | 

DEVICE | 

CODE | 

112 ! 


REMOTE | 

DEVICE | 

CODE { 


I Medium-speed i 


113 j 




! High-speed | 


114 ! 






| Remote j 




145 j 


| Line printer 
i (BIOC) 


j Local | 


40 ! 




i Tape cassette 


i Intertape 1 


66 ! 




I Magnetic tape 


i 800 bpi (bits per inch) | 


64 ! 






j 1600/800 bpi | 


65 ! 






| 6250/1600/800 bpi STC j 


68 ! 






! 6250/1600/800 bpi STC | 
| halfword mode I 

! 6250/1600/800 bpi TELEX j 
I tape with standard | 
I controller i 


69 ! 

70 | 




I Disks 


| 50Mb CDD50, fixed | 
| portion (25Mb) i 

1 50Mb CDD50, removable | 
| portion (25Mb) I 

I 256Mb disk, fixed | 


42 ! 

43 ! 






44 ! 






! 1.5Mb, HPT | 


45 ! 






1 160Mb, fixed | 


46 | 






| 1.5Mb HPT ! 


47 ! 






I 2.5Mb disk, fixed | 


48 ! 






i 2.5Mb disk, removable | 


49 j 






i 5Mb disk, fixed ! 


50 { 






| 5Mb disk, removable J 


51 ! 
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TABLE 4-2 CATEGORIES OF OS/32-SUPPORTED DEVICES (Continued) 



I I LOCAL | REMOTE j 

i ! DEVICE J DEVICE | 

TYPE | DEVICE | CODE j CODE | 

Disks | 40Mb disk, removable | 52 | I 


i 67Mb di3k, removable | 53 | | 


| 256Mb disk, removable j 54 | | 


I 68.5Mb disk, fixed | 56 | | 


| 1.5Mb disk, HPT i 57 i i 


i 67Mb disk, fixed | 58 i i 


| 16Mb disk, removable j 59 | j 


i 16Mb disk, fixed j 60 i | 


I 48Mb disk, fixed i 61 i | 


I 80Mb disk, fixed j 62 j i 


I 675Mb disk, fixed | 63 | | 


Floppy disk i Floppy disk | 55 | | 


Local VDU | Nonediting VDU (CLCM) { | | 

i (RS-232C) i 34 | 147 | 


| GDT, (CLCM) (RS-232C) | | | 


i Carousel 300 (CLCM) j | | 
! (RS-232C) ! 37 | 147 | 


i Carousel 300 with j j I 
I electronic forms control | j | 
! (CLCM) (RS-232C) j 38 j 147 j 


I Models 550, 1100 and I | i 
! 6100 (CLCM) (RS-232C) j 39 j 147 j 


8-line inter- i 8-line interrupt module i j | 
rupt module | i 128 | | 


Digital MUX | Digital MUX controller j 129 i ! 
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TABLE 4-2 CATEGORIES OF OS/3 2 -SUPPORTED DEVICES (Continued) 



II ! LOCAL | REMOTE | 
! | | DEVICE | DEVICE j 
I TYPE | DEVICE j CODE j CODE 1 

| Conversion | Real-time analog system j j i 
| equipment | with internal clock i 136 i ! 

I I Real-time analog system j | | 
! i with user-supplied i ! I 
I i external clock i 137 | | 


I Analog I/O i Mini I/O analog input | 138 | | 


i Lonuroiier t _ _. _. , _ ( 
I ! Mini I/O analog output | 139 j ! 


i Digital I/O | I i ! 
| Controller i Mini I/O digital | 140 | ! 

| I/O Bus Switch | I/O Bus Switch ! 143 | | 

| Communication ! Asynchronous communica- | i 1 
i Devices I tions line, line driver i ! 1 
i I only i i 144 ! 

j i Remote line printer and | i ! 
j I letter quality printer i | 145 | 

| | SIGMA 10 terminal j i J 46 | 

| ! Nonediting VDU (CLI) i 18 i 147 | 

! ! Models 550 and 1100 VDU | | I 
! ! (CLI) I 39 ! 147 ! 

| i TEC 455 editing VDU | | 155 j 

! i Model 1200 VDU | ! 156 1 

j | Model 1250 point-to- ! i 1 
! I point VDU; Series 7000 J ! 1 
| i 8-bit data transfer j | 157 | 


| I Model 1250 multidrop VDU | | 158 | 

| I Binary synchronous on ! ! ! 
! i 201 DSA r line driver | I i 
! I only i | 160 j 


| j IBM 3780 RJE emulation I i ! 
i | on 201 DSA i I 161 j 
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TABLE 4-2 CATEGORIES OP OS/32-SUPPORTED DEVICES (Continued) 




Communication 

Device 

(Continued) 



DEVICE | 

IBM 2780 RJE emulation | 
on 201 DSA | 


LOCAL | REMOTE 

DEVICE | DEVICE 

CODE i CODE 

! 162 


Binary synchronous | 
processor-to-processor | 
on 201 DSA | 


! 163 


Binary synchronous on | 
QSA, line driver only ! 


I 168 


IBM 3780 RJE emulation j 
on QSA ! 


! 169 


IBM 2780 RJE emulation | 
on QSA | 


! 170 


Binary synchronous | 
processor-to-processor | 
link on QSA | 


i 171 


Binary synchronous IBM | 
3270 link on QSA j 


j 172 


ZBID line driver on QSA; | 
SVC15 access only? | 
half -duplex j 


i J 76 


ZBID line driver on QSA; | 
SVC15 access only; | 
simplex I/O ! 


! 177 


ZBID CTM on QSA; | 
TWS operational mode; | 
SVCl access only; | 
simplex input; "mother" j 
to device 179 j 


! 178 


ZBID CTM on QSA; TWS j 
operational mode; SVCl | 
access only; simplex | 
output; "daughter" to | 
device 178 | 


| 179 


ZBID CTM on QSA; TWA j 
operational mode; SVCl | 
access only; half-duplex | 


I J 80 



4-12 



48-037 F00 R02 



TABLE 4-2 CATEGORIES OF OS/3 2 -SUPPORTED DEVICES (Continued) 



TYPE 

Communication 

Devices 

(Continued) 



I LOCAL | REMOTE 
| DEVICE ! DEVICE 
DEVICE | CODE j CODE 

ZBID CTM on QSA; TWS. j | 
operational mode; SVCl j | 
access only; simplex j j 
input; "mother" (with J | 
assembled DCT) to device | j 
182 j | 181 

ZBID CTM on QSA; TWS J j 
operational mode; SVCl J j 
access only; simplex | j 
output; "daughter" to | | 
device 181 j | 382 

ZBID CTM on QSA; TWA | j 
operational mode; SVCl j j 
access only; half -duplex; j j 
with assembled DCT j | 183 


Binary synchronous IBM j j 
3270 emulation on QSA j j 185 

ZBID CTM for X.25 level | ] 
3 on QSA; TWS operational! i 
mode; SVCl access only; | | 
simplex input; "mother" | | 
to device 187 | j 186 

ZBID CTM for X.25 level | j 
3 on QSA; TWS operational! ! 
mode; SVCl access only; j J 
simplex output; j | 
"daughter" to device 186 j J 187 

DIOS | ! 192 


Ethernet line driver on i | 
Ethernet controller; j | 
SVC15 access only; | | 
simplex input; read side | | 
(must be used together j | 
with write side) | j 212 


Ethernet line driver on | | 
Ethernet controller; i | 
SVC15 access only; j | 
simplex output; write i | 
side (must be used j | 
together with read side) | j 213 
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4.3 DEVICES USING CURRENT LOOP INTERFACE (CLI) 

Devices using CLI can be used as the console device. These 
devices connected to the CLI can be configured in the system: 



• Carousel 15, 30, 35 

• Carousel 300 

• Model 33 TTY 

• Model 35 TTY 

• Nonediting VDU 

• Model 550 

• Model 1100 



When the paper tape reader /punch and keyboard/printer features of 
the TTY and Carousel devices are both supported, a shared-busy 
condition exists, since these devices are configured at the same 
address . 



NOTE 

If the reader/punch feature is supported 
by an (ASR) TTY console device, the 
reader/punch feature must not be assigned 
to a user task (u-task) . 

If a Carousel supports paper tape, it can 
only support the paper tape reader 
feature. 



Examples : 



TTY: ,2, 016, CONS 
TRP1: 2,081 



*Model 33, console device 
*Reader /punch, same device 



4.4 DEVICES USING STANDARD RS-232C INTERFACE (PALS, PASLA, 
2- OR 8 -LINE COMMUNICATIONS MULTIPLEXOR) OR CURRENT LOOP 
COMMUNICATIONS MULTIPLEXOR (CLCM) 

Devices using the standard RS-232C interface or CLCM can be used 
as the console device. The following devices connected to the 
standard RS-232C interface or CLCM can be configured in the 
system: 
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• Nonediting VDU 

• Graphic display terminal 

• Carousel 300 

• Carousel 300 with electronic format control (EFC) 

• Model 550 (nonediting) VDU 

• Model 1100 (nonediting) VDU 

• Model 1200 (editing) VDU 

• Model 1250 (editing) VDU 

• Model 6100 VDU 



Because the editing features of Model 1200 and 1250 are not 
currently supported by the VDU driver, both models must be 
configured as a nonediting VDU. Communication supports the 
editing features of Model 1200 and 1250. See the OS/32 Basic 
Data Communications Reference Manual for details of this support. 

CAUTION 

DO NOT USE MODEL 1200 AND 1250 SYSTEMS 

WITH THE EDITING FEATURE AS THE CONSOLE 

DEVICE, BECAUSE DATA WRITTEN TO THE 
DEVICE CAN LOCK THE KEYBOARD. 



The default strapping for PALS, PASLA, 2- and 8-line 
communications MUX, and CLCM is as follows: 

• The clocks are strapped to a baud rate between 110 and 9600. 
A clock is selected when the device begins an I/O operation. 

• The function switches for Model 1100, 1200 and 1250 Systems 
should be set for even parity. All other devices should be 
set for no parity. 

• The interface must be strapped full-duplex, disable CARR 
status, disable DSRDY status and disable CL2S for nonediting 
VDUs, graphic display terminals and Carousels. For the Model 
1100, 1200 and 1250 VDUs, the interface must be strapped 
full-duplex, enable CARR status, enable DSRDY status and 
enable CL2S status. 
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4.4.1 The Bidirectional Input/Output Control (BIOC) 

With the release of OS R06.2, the standard local CRT driver is 
the BIOC driver, which will be configured in the system by 
default at sysgen time. Certain features of the BIOC driver can 
be enabled and disabled. To do this, the following parameters 
can be specified in the DEVICES. . .ENDD statements: 



RECLEN-n 

SIZE=n 

XCOD=n 



where n is the number of characters per line. 

where n is the number of lines per page. 

where n specifies a half word with bit 
definitions explained in Table 4-3. 



NOTE 

The XDCOD= and CLOCK= parameters are 
mutually exclusive when establishing a 
BIOC DCB. The user can mask in clock 
support through the XDCOD parameters 
shown in Section 2.3.11. 



TABLE 4-3 BIOC XDCOD BIT DESCRIPTIONS 



BIT | HEX | MEANING 

! 8000 S Support ITAM extended option connect/disconnect. 


1 | 4000 ! Suppress BREAK/ESC function. Selection of this 
I j option prevents actuation of a BREAK from 
1 ! causing an I/O error on remote printers. 

2 | 2000 | Enable CTRL-A to cause entry into baud adjust 
I | routine. Selection of this option allows local 
I I terminals to select different baud rates. 

3 ! 1000 | Suppress write time-out if carrier is off. 
1 | Selection of this option allows a dial-in user 

I | to be welcomed by multi-terminal monitor (MTM)'s 
! | ID message at the completion of baud adjust. 
1 I This bit takes precedence over bit on write 
I | reguests and should not be set if bit is set. 
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TABLE 4-3 BIOC XDCOD BIT DESCRIPTIONS (Continued) 



I BIT j HEX | MEANING j 

j SaBBBKmai9irr- i ' l BBX«BSSSXX3BS»BSBHtZXBSSa:BSESa&S3S;£.JCas&B&KS£BSaBSBB | 

I 4 | 0800 j Support full BIOC functions. Selection of this | 
j | | option enables the full complement of BIOC | 
I | | features. If this option is not selected, the | 
i | | ASCII read functions will be limited to CTRL-H, j 
| | | as a nondestructive backspace, and CTRL-X, as 1 
I j j a cancel line request. In addition, CTRL-Q | 
i | | through CTRI>T will be stripped from the input 1 
| | i to allow full implementation of flow control as i 
I | j used by some data-concentrators. j 


i *~ ~ _ _j 

| 5 | 0400 | Suppress mark off of devices at sys-init time | 
I j | for false sync. At system boot or hot-start, | 
| | | BIOC addresses every device that has been | 
i | | sysgened with its DCBs. If BIOC receives a | 
| | | false sync in response to an output command, it i 
| | | marks that device off. If a system has j 
| | | devices on bus-switches, the power fail delay | 
j | | may result in these devices being marked off. j 
| j 1 If the above conditions cause problems, it is | 
i i j advisable to suppress this feature at sysgen ! 
t j j time. j 


I 6 | 0200 | Support carriage return (CR) as termination for | 
I j | image read. Normally, image reads are termi- j 
I | | nated only with buffer-full or break. Selection i 
I j j of this option enables CTRL-M to terminate the | 
i j | read. If CTRL-M is used to terminate the read, i 
i j j it will not be echoed to the terminal but it | 
| | | will be placed into the buffer as data. i 


i 7-15 | 01FF j Select command 2 for choice of stop bits, data | 
j | | bits, parity and clock rate. (Consult the ap- | 
| j | propriate interface, i.e., 2- and 8-line | 
j | | COMM MUX, MPC, etc., programming manual for j 
j II specific information.) If bit 7 is a 1, bits | 
I j | 8-15 will be used as the entire command 2. If I 
j | | bit 7 is a 0, bits 8-11 must be and bits | 
i | | 12-15 can be A, B, C, D or to select only I 
i | j the clock rate. When bit 7 is 0, the default | 
I | | defined by the DCB is used for the other i 
I | | options. 1 

I ! LN | Specifies terminal/printer logical record | 
i | j length. Normally this length is the number of j 
j j | characters that can be printed on one line. I 


I i PS | Specifies terminal/printer page size. Normally | 
| | | thi3 size is the number of lines that can be i 
i | | printed on one page. 1 
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The BIOC default interface strappings are as follows: 

• The clocks are strapped to baud rates between 50 and 19,200. 
A clock is selected when the device begins an I/O operation. 
The initial clock can be selected by the SYSGEN statement, but 
can be changed through the use of the auto-baud adjustable 
feature. 

• The function switches for Perkin-Elmer Model 1100 and 1200 
terminals (device code 39) should be set for even parity. All 
other devices (device codes 34, 38 and 40) should be set for 
no parity. 

• The interface must be strapped full-duplex. In most local 
applications, CARR, DSRDY and CL2S status lines should be 
disabled. For Perkin-Elmer Model 1100 and 1200 terminals and 
dial-in applications, CARR, DSRDY and CL2S are usually 
enabled. 

• For dial-in applications, a modem cable should be used. BIOC 
uses the CARR status to detect the disconnection of dial-in 
lines. When CARR drops, BIOC returns I/O errors to ensure 
that the user is terminated from an active MTM environment. 
If this response is not desired, CARR status should be 
disabled. 

• Enabling CL2S status will prevent writes from proceeding if a 
port is not connected. The time-out status that would result 
from this condition will usually result in loss of the data 
being written, the MTM ID message, for example. For this 
reason, BIOC allows the user to selectively suppress write 
time-outs if CARR status is also absent. This is typically 
used on dial- in lines when the user wants to display the MTM 
ID message upon completion of the auto-baud adjust. 

4.5 INTERTAPE CASSETTES 

The two cassettes located in a transport are interlocked in the 
hardware, causing a shared-busy condition. 

Example: 

CAS1:,45,066 *Two cassettes on 

CAS2:,55,066 *same transport 

4.6 CARD READERS 

These card readers can be configured in the system: 

• Card reader 029 with software code translation 
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• Card reader 029 with hardware code translation 

• Card reader 026 with software code translation 

There is an additional feature of the 026 and 029 card reader 
drivers that can be included in the system at sysgen time. The 
driver can translate the Hollerith code into EBCDIC instead of 
ASCII code. This feature can be included by specifying the 
following translate tables in the device statement: 

• INITRE26, which converts all 026 card reader codes directly to 
EBCDIC representation in memory 

• INITRE29, which converts all 029 card reader codes directly to 
EBCDIC representation in memory 

Example: 

CR29:,04,96 *Standard card reader, software 

translate, 029 card encoding 

CRHW:,04,97 *Card reader, hardware 

translate, 029 card encoding 

CR26:,04,98 *Standard card reader, software 

translate, 026 card encoding 



4.7 CARD PUNCHES 

These card punches can be configured in the system: 

• High-speed 029 card encoding 

• Card reader /punch (interpreting) 

• Card reader /punch 029 card encoding with print option 

As supplied, these devices translate 029 Hollerith 
code to/from ASCII. There is an additional feature of the card 
punch and card reader/punch that can be included in the system. 
Optionally, the devices can translate 026 Hollerith 
code to/from ASCII, 026 Hollerith code to/from EBCDIC, or 029 
Hollerith code to/from EBCDIC. These features can be included by 
referencing the following translate tables in the device 
statement : 

• INITPA26 or INITRA26, which converts all 026 card codes 
directly to ASCII representation in memory 
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• INITPE29 or INITRE29, which converts all 029 card codes 
directly to EBCDIC representation in memory 

• INITPE26 or INITRE26, which converts all 026 card codes 
directly to EBCDIC representation in memory 

Example: 

CP:,7,104 *High-speed card punch 

CRP:,8,105 *Card reader/punch 

CRPS: f 9 r 106 *Card reader /punch with print separate 

4-8 LINE PRINTERS 

These line printers can be configured in the system: 

• 60-200 1pm (lines per minute) printer 

• 300 1pm printer 

• 600 1pm, 1000 1pm printer 

• Remote serial line printer and letter quality printer 

Example: 

LPR1:,62,112 *Low-speed printer (60-200 1pm) 

LPR2:,63,113 *Medium-speed printer (300 1pm) 

LPR3: ,72,114 *High-speed printer (600 1pm, 

100 1pm) 
RMOT: ,48,145,XDCD=X'800 Serial line printer (110 baud 

through 9600) 

4.9 HIGH-SPEED PAPER TAPE READER/PUNCH 

High-speed paper tape reader/punches can be configured in the 
system. 

Example: 

PRTP:,13,80 *High-speed paper tape reader /punch 
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4.10 MAGNETIC TAPE CONTROLLERS AND TAPES 

Magnetic tape controllers are specified in the controller option 
of the device statements. A magnetic tape controller supports 
from one-to-four transports. 

The device statement for the tapes must identify the tapes for 
each controller. Each tape requires a device statement that 
allows more than one tape to be active at one time. The 
following magnetic tapes can be configured in the system: 

• 800 bpi magnetic tapes 

• 1600 bpi magnetic tapes 

• 1600/800 bpi dual density magnetic tape drives 

• 6250 bpi magnetic tapes - special systems controller (STC) 

• 6250 bpi - halfword mode controller (STC) 

• 6250 bpi - TELEX tape device 

The 6250 tape drives may require extended direct memory access 
(EDMA) bandwidth coordination. The 6250 tape drives can run with 
gaps or in gapless mode. 

Example: 

MAGI: ,85,64, CONTR=0,SELCH=F0 *Tapel (800 bpi) 

MAG2: ,95,64,CONTR=0,SELCH=F0 *Tape2 (800 bpi) 

MAG3: ,C5,65,CONTR=l r SELCH=F0 *Tape3 (1600 bpi) 

MAG4: ,D5,65,CONTR=l,SELCH=F0 *Tape4 (1600 bpi) 

MAG5: ,80,68 ,SELCH=F0, CONTR-2 *Tape5 (6250 bpi) 

MAG6: ,90,68,SELCH=F0,CONTR=2 *Tape6 (6250 bpi) 

4.11 DISKS 

All Perkin-Elmer -supported disks have one physical disk volume 
per disk drive, except for the 10Mb disk (M46-416), which is 
composed of two 5Mb disk volumes, and the 68.5Mb disk, which is 
composed of a 1.5Mb disk and a 67Mb disk. 
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The driver allows many of the mass storage media (MSM) disks to 
be divided into two or more virtual disks. This capability is 
described in Section 4.11.2.2. Three algorithms are available 
for scheduling I/O queued to a disk: priority, 
first-in/first-out (FIFO) and seek optimization (C-SCAN). The 
C-SCAN algorithm is supplied as a default and is used to produce 
the highest throughput on the disk by reducing the number and 
range of seek operations. It includes an adjustment to prevent 
one task from queuing many consecutive I/Os. If a task request 
is queued ahead of all other requests, and the current I/O is 
being executed for this same task, then this request is scheduled 
on the next scan of the arm. 

The priority and FIFO algorithms are selected by specifying the 
QUEUE option in the device statement. For priority scheduling, 
DISKQ is changed to COMQ. For FIFO, it is changed to COMFIFO. 
Priority schedules by calling task priority and then FIFO within 
each priority level. FIFO schedules without regard to priority 
or disk position. 

A second option is the elimination of the EDMA coordination 
overhead in the systems that do not require memory bandwidth 
monitoring. This option is not selectable by an option on the 
device statement. This is accomplished in the DCB macro for the 
desired disk type (see Section 4.11.1) in the macro library 
SYSGEN32.MLB. 

To remove EDMA coordination from an MSM300 removable disk (device 
code 54), use the LIST command of the Macro Library Utility to 
save macro DCB54 of SYSGEN32.MLB to a new file. Then, use the 
OS/32 EDIT GET command to retrieve this new file and locate the 
string EDMA=SEEKCHK, an argument to the DCB I macro call. Delete 
the string and save the edited file. Using the Macro Library 
Utility, include this edited file in the USERDLIB.MLB, the DCB 
macro library provided for user -written drivers. 



NOTE 

This option is not recommended unless a 
careful analysis of the hardware 
configuration has verified that memory 
bandwidth monitoring is not required. 

4.11.1 Moving-Head Disks 

A moving-head disk controller supports from one-to-four disk 
drives. The device statements for the disks must identify the 
SELCH and controller address. 

The following disks can be configured in the system: 
• 2.5Mb, fixed 
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• 2.5Mb, removable 

• 5Mb, fixed | 

> Compose a 10Mb disk 

• 5Mb, removable) 

• 40Mb, removable 

The 10Mb disk is composed of two 5Mb disks. These two disks 
share the same drive, causing a shared -busy condition. Two 
device statements must be specified for a 10Mb disk. The 
shared-busy conflict is resolved by Sysgen/32, based on the 
device code/device address. 

Example : 

DSC1: ,C6,51,SELCH=F0,CONTR=B6 *Removable 

DSC2: ,C7,50,SELCH=F0,CONTR=B6 *Fixed 

DSC3: ,D6,51,SELCH=F0,CONTR=B6 *Removable 

DSC4: ,D7,50,SELCH=F0,CONTR=B6 *Fixed 

DSC1 and DSC2 have a shared-busy condition, as do DSC3 and DSC4. 

4.11.2 Mass Storage Media (MSM) Disks 
These disks can be configured in the system: 

• MSM300 256Mb, fixed 

• MSM300 256Mb, removable 

• MSM80 67Mb, removable 

• MSM80 67Mb, fixed ) 

/ Compose a 68.5Mb disk 

• MSM80 HPT 1.5Mb, fixed) 

• MSM80 HPT 68.5Mb, fixed and removable 

• MSM1.5 HPT of 675, fixed 

• MSM160 , f ixed 



The 68.5Mb MSM HPT disk is compo:sed of a 1.5Mb fixed -head disk 
and an MSM 67Mb fixed disk. 
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4.11.2.1 Mass Storage Media (MSM) Dual Port Option 



| If the disk drive is configured with a dual port option, meaning 

| it is shared with another system, then the dual port option 

! (DUAL) must be specified in the device statement. If this 

| parameter is omitted, the disk driver will treat the alternate 

I channel busy condition as an error. 



An example of the MSM disk with dual port option is as follows: 
D3Q0: ,EC,54,SELCH=Fl,CONTR=EB,DUAL 256Mb removable - dual port 

4.11.2.2 Mass Storage Media (MSM) Virtual Disk Option 

The MSM driver supports a virtual disk option on those device 
codes marked with an asterisk in Table 4-4. A virtual device is 
an area of contiguous cylinders on an MSM disk that appears to 
the system as. a real physical disk. A virtual disk can be 
initialized and checked with FASTCHEK, dumped and restored using 
FASTBACK or BACKUP, marked on/off and used just as any other 
disk. 

Virtual disk can be used for the following purposes. 

• Virtual disk provides dedicated spool, temporary and roll 
volumes, without wasting an entire physical disk. This 
significantly reduces fragmentation on the permanent file 
storage volumes, and it also reduces allocation time for 
spool, roll and temporary files. 

• Virtual disk provides additional smaller user volumes. This 
can reduce file allocation time by reducing the size of the 
directories to be searched. It also allows separate groups, 
departments or projects to be assigned private volumes.. 

• Virtual disk provides additional scratch volumes that do not 
need to be backed up. This helps reduce fragmentation on more 
permanent storage volumes. 

• Virtual disk allocates relatively small dedicated volumes for 
fairly static usage such as the system volume/system account 
or the on-line source, documentation, etc., of a mature 
software project. 

Virtual disk can provide significant performance improvements and 
operational convenience. However, there are several cautions, 
which are listed below. 
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• The amount of memory used increases, due to the fact that an 
additional disk DCB is included for each virtual and physical 
disk configured. Also, additional system space is required if 
the disk is marked on with core directory support. 

« If an existing disk drive is reconfigured as multiple virtual 
disks, the existing data must be backed up and redistributed 
among the virtual volumes after booting the new system and 
initializing the virtual disks. 

• Once a physical disk has oeen initialized as multiple virtual 
disks, that disk pack (if removable) is locked into that 
particular drive and sysgen or one configured exactly the 
same. Furthermore, the drive is restricted to disk packs for 
which the virtual disk layout matches the sysgened layout. 
For this reason, it is recommended that removable drives be 
sysgened as a whole disk in addition to several virtual disks. 

«» All virtual disks on a removable disk must be marked off 
before removing the disk platter. The operating system does 
not enforce this. 

» Virtual disks must be checked and backed up individually. 

» The loader storage unit (LSU) can only boot an operating 
system from a virtual disk that starts at cylinder zero. 

Virtual disks are configured by specifying two or more disks at 
the same address and using the VIRT= parameter of the 
DEVICES. . .ENDD statement to specify the starting cylinder and 
number of cylinders for the virtual disk. Cylinders are counted 
starting at zero. The number of usable cylinders for each MSM 
disk is given in Table 4-4. Virtual disks must not overlap, nor 
is the last virtual disk permitted to extend beyond the end of 
the physical disk. Neither Sysgen/32 nor the operating system 
(OS) enforces these restrictions; therefore, the user must 
exercise caution in configuring the system. 

To determine the number of cylinders to allocate, divide the 
desired amount of disk storage per volume by the cylinder size. 
Cylinder size can be calculated from the information given in 
Table 4-4 by the following formula: 

Cylsize = (sectors/track) * (tracks/cylinder ) *0.25kb/sector 



The following are examples of MSM disks with virtual disk | 
options: ■ 
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D300: ,EC,54,SELCH=F1,C0NTR=EB Note 1 

DV01:,EC,54,SELCH=Fl,CONTR=EB,VIRT=(Qr323) Notes 2 and 3 

DV02 : , EC , 54 , SELCH=F 1 , CONTR=EB , VIRT= ( 323 , 250 ) Note 4 

DV03: f EC f 54,SELCH=F1,C0NTR=EB, VIRT=(773 , 250) Notes 5 and 6 



NOTES 

1. D300 is an entire 256Mb removable 
disk at locations. EC, EB and Fl. 
This device must not be marked on 
while any of the virtual disks are 
on-line. The disk normally allows 
access to disk packs that have not 
been initialized with virtual disks. 

2. Virtual volume number 1 on D300 
(DV01) contains 323 cylinders 
starting at cylinder zero. 

3. The LSU can boot from this volume 
because it starts at cylinder zero. 

4. DV02 contains 250 cylinders starting 
at cylinder 323. 



D. 



DV03 contains 250 cylinders starting 
at cylinder 773. 



6. Note that the number of cylinders in 
the virtual disks total 823. This 
number of total cylinders can be 
located in Table 4-4 under device 



j number 54. 



I/O error recording is supported for MSM 
disks only. Tables 4-1 and 4-2 contain 
the device codes for MSM disks. Table 
4-4 contains an expanded listing of MSM 
disks. 
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TABLE 4-4 DEVICE CODES FOR MSM 



j ! i 1 TRACKS | CYLIN- i MAIN- | i 
| i | SECTORS | PER j DERS I TENANCE i j 
! DEVICE | DEVICE | PER } CYLIN- { ON | CYLIN- | RELATED | 
!; CODE | TYPE | TRACK I DERS i DISK j DERS | DEVICES | 

j; sssssneaR*ds:tiAa:ss:sssa;s;sBaaesscKsaaKaeseKBisiDJBSss!asss:ff = «sKS'ss9xx = sas7 j 

I 44* | 256Mb, ! 64 j 19 i 1022 i 2 i - ! 


| 45 i 1.5Mb, | 64 j 10 | 9.6 | | 46 | 
I i HPT | | 1 ! ! ! 


! 46* | 160Mb, ! 64 j 10 I 821 | 2 ! 45 | 
1 I fixed | i | I I I 


! 47 | 1.5Mb, | 64 | 40 j 2.4 j - j 63 | 
I ! HPT j II! 1 1 


i 53* | 67Mb, | 64 | 5 1 823 | - 1 - 1 
I | remov- I I ! ! 1 1 
I i able | III i 1 


| 54* | 256Mb, j 64 J 19 1 823 | - 1 - I 
| | remov- | ill 1 1 
1 I able | | II 1 1 


| 56 | 68.5Mb, | 64 j 5 j 836.2 | 3 j - 1 
I | fixed | III ! 1 


| 57 | 1.5Mb, | 64 | 5 i 19 . 2 j - I 58 | 
I | HPT i ill i I 


| 58* | 67Mb, | 64 | 5 1 820 I 3 | 57 I 
1 I fixed | ill 1 1 


| 59* | 16Mb, | 64 | 1 I 823 j - 1 60,61,62| 
I | remov- | III 1 1 
j I able | I 1 ! II 


| 60* | 16Mb, | 64 | 1| 821 | 2 I 59 j 
! ! fixed | til I < 


| 61* | 48Mb, | 64 I 3 1 821 | 2 | 59 | 
1 | fixed | ill 1 1 


I 62* | 80Mb, | 64 | 5 1 821 | 2 | 59 | 
I 1 fixed j II! ! 1 


{ 63* j 675Mb, i 64 i 40 i 821 ! 2 I 47 I 
1 I fixed III!!! 



* Supports virtual disk 
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i Examples of MSM disks: 

| MSM1: ,FC,53,SELCH«F0,CONTR-FB 67Mb disk, removable 
MSM2: ,FD, 53, SELCH-FO , CONTR-FB 67Mb disk, removable 
MSM3: ,FE,58,SELCH«=F0,CONTR«FB 67disk, fixed 
HPT3: ,FE, 57, SELCH-FO, CONTR-FB 1.5Mb HPT 
MSX3: ,FE,56,SELCH=F0,CONTR=FB 67 + 1.5Mb, fixed :. 



D300: ,EC,54,SELCH=F1,C0NTR-EB 256Mb disk, removable 
D301: ,EC,54,SELCH=F1,C0NTR=EB 56Mb disk, removable 

4.11.3 Direct Memory Access (DMA) Coordination Nodes 

It is possible to configure DMA devices whose total bandwidth 
would exceed the capacity of the EDMA bus. To prevent the 
resultant data overruns and inefficient operation, coordination 
of EDMA activity can be configured by using the EDMA node. 
Generally, the 6250 bpi, 125 inches per second (ips) and the MSM 
disks are considered for EDMA coordination. Only when present in 
extreme numbers on the Model 7/32 processor would the slower 
tapes and disks be considered for coordination. 

If the number of channels is greater than the number of 
simultaneous data transfers allowed in the system, a DMA 
coordination node must be configured. However, if the number of 
channels is less than or equal to the number of simultaneous data 
transfers allowed, no coordination statements are required. 

DMA coordination is specified in the COORDINATION statement. 
Example: 

DSC1: ,FC, 53, SELCH-FO, CONTR=FB *67Mb (MSM80) disk 

DSC2: ,EC,53,SELCH-F1,C0NTR=EB *67Mb (MSM80) disk2 

Magi: ,85,68, SELCH=F2,CONTR=0 *6250 bpi, 125 ips magnetic 

tape dr iver 
COORDINATION=°TRANSFER=4,SELCH=(FO,F1,F2) 

4.11.4 Floppy Disk Subsystems 

A floppy disk subsystem consists of one controller with 
one-to-four spindles. The controller is transparent to the user. 
All spindles share the same controller, causing a shared-busy 
condition. The shared-busy conflict is resolved by SYSGEN/32 
based on the device address configuration described in Section 
2.2.11. 

The device statement for the disk has a device mnemonic 
associated with the drive only when the disk is marked off-line. 
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Two algorithms are available for scheduling I/O queued to a 
floppy disk: 



• Pr ior ity 

• FIFO 



The priority algorithm is selected by specifying the QUEUE option 
in the device statement. For priority scheduling, COMFIFO is 
changed to COMQ. Priority schedules by calling task priority and 
then FIFO within each priority level. The default algorithm is 
FIFO. FIFO schedules without regard to priority or disk 
position. 

A second option available is elimination of the EDMA coordination 
overhead in systems that do not require EDMA coordination. The 
field DCB.EDMA should be left at zero. This is accomplished in 
the DCBINI macro in SYSGEN32 .MLB by omitting EDMA=SEEKCHK . 

If there is more than one floppy disk subsystem in the system, a 
DMA coordination node must be configured above the subsystems it 
controls. If a DMA coordination node is not defined, 
intermittent I/O errors, loss of data or system failure can 
occur. Although the floppy disk is not a DMA device, it uses the 
same coordination methods to operate within the bandwidth 
limitations of the controller. 

The device statement for each spindle has: 

• a device mnemonic associated with the spindle, and 

• a spindle number (0, 1, 2 or 3) specified in the SPINDLE 
option of the device statement. 



Examples : 



FLP1:C1,055,SPINDLE=0 
FLP2:C1,055,SPINDLE=1 
FLP3:C1,055,SPINDLE=2 

FLP1:C1,055,SPINDLE=0 
FLP2 : CI , 055 , SP INDLE=1 
FLP3 : CI , 055 , SP INDLE=2 
FLPA:C2,055,SPINDLE=0 
FLPB:C2,055,SPINDLE=1 



*First floppy disk spindle 
*Second floppy disk spindle 
*Third floppy disk spindle 

*First spindle for subsysteml 
*Second spindle for subsysteml 
*Third spindle for subsysteml 
*First spindle for subsystem2 
*Second spindle for subsystem2 



COORD DEV=(FLP1,FLP2,FLP3,FLPA,FLPB) ,TRANSFER=1 
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4.11.5 50Mb Cartridge Disk Drive (CDD50) Subsystem 

The CDD50 subsystem, supplied with the basic Model 3205 System, 
consists of one 50Mb CDD50, a 1 by 4 intelligent disk controller 
(IDC), power supply, rack-mounting hardware and necessary cables. 

The CDD50 provides both removable and fixed storage. The 
unformatted capacity of the CDD50 is 50Mb. The removable disk 
cartridge provides 25Mb of storage with the remaining 251Mb being 
provided by the nonremovable disk. The CDD50 has a transfer rate 
of 1.2Mb per second, an average access time of 35ms and an 
average rotational latency of 8.55ms. 

4.12 8-LINE INTERRUPT MODULE 

Each 8-line interrupt module must be defined by a device 
statement. Trap-generating device (TGD) support must be included 
in the system at sysgen time for an 8-line interrupt module. 



Example : 



LINO 
LIN1 
LIN2 
LIN3 
LIN4 
LIN5 
LIN6 
LIN7 



,20,128 
,21,128 
,22,128 
,23,128 
,24,128 
,25,128 
,26,128 
,27,128 



4.13 SYSGEN ING A 
(COMM MUX) 



SYSTEM WITH A COMMUNICATIONS MULTIPLEXOR 



The COMM MUX interfaces a Perkin-Elmer Series 3200 processor, via 
a MUX bus, to various device controllers. It is available in the 
2- and 8- line version. Each line can be strapped for one of four 
groups, with each group containing four program-selectable clock 
rates. The COMM MUX baud rate is made compatible to the device 
by selecting the clock that matches the desired baud rate. The 
selected clock is specified by the CLOCK option of the device 
statement (see Table 4-5). 
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TABLE 4-5 BAUD RATES WITHIN 
AN INSTALLED GROUP 



I STRAP 


BAUD 


1 


| OPTION 


RATE 


j CLOCK 


j ssjEBaassssse:9:SBBBiBBsiss 


======== 


| Group 1 


50 


| XA 




110 


i XB 




1,800 


I XC 




2,400 


j XD 


i Group 2 


75 


| XA 




134.5 


| XB 




2,000 


! XC 




3,600 


i XD 


| Group 3 


150 


j XA 




600 


I XB 




4,800 


\ XC 




9,600 


| XD 


I Group 4 


300 


j XA 




1,200 


j XB 




7,200 


I XC 


i 


19,200 


| XD 



4.14 CONVERSION EQUIPMENT CONTROLLER (MINI INPUT/OUTPUT (I/O) | 
SYSTEM) ! 

These conversion equipment controllers can be configured in the 
system: 



• Real-time analog system 

• Analog input controller 

• Analog output controller 

• Digital I/O controller 

Example: 



RTAS:,83,136 
AIC: ,88,138 
A0C1:,98,139 
AOC2: ,99,139 
DIC: ,A9,140 
DOC: ,A8,140 



*Real time analog system 
*Analog input controller 
*Analog output controller! 
*Analog output controller2 
*Digital input controller 
*Digital output controller 
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CHAPTER 5 
SAMPLE SYSTEM GENERATION/32 (SYSGEN/32) SESSIONS 



5.1 INTRODUCTION 

This chapter is presented to guide the less experienced user 
through the initial Sysgen/32 session. It is assumed that the 
user has read the previous chapters (Chapter 1 in particular) in 
this manual before attempting to use Sysgen/32. This chapter 
identifies three general situations and then presents a sample 
Sysgen/32 session that can be used for each situation. One of 
these situations should apply to a user about to use Sysgen/32 
for the first time. The sample Sysgen/32 sessions presented are 
not the only way Sysgen/32 can be used in these situations. As 
the user becomes more familiar with the Sysgen/32 process, these 
samples need not be used. However , for the first-time user, an 
easy-to-follow procedure for using Sysgen/32 is provided. 

5.2 SYSTEM GENERATION/32 (SYSGEN/32) START-UP SITUATIONS 

When the user is ready to perform a sysgen operation, one of the 
following three situations will likely exist: 

• A configuration input file has been previously created and 
must now be processed. 

• No previously created configuration input file exists. The 
user wishes to create a configuration input file in the 
conversational mode and then process it. 

• No previously created configuration input file exists. The 
user wishes to create a configuration input file in the 
interactive mode and then process it. 

In each situation, the user must first load and then start the 
Sysgen/32 program using the system LOAD and START commands, 
respectively. The following three sections provide a sample 
Sysgen/32 session for each of the three situations described 
above. The user should note that these are sample Sysgen/32 
sessions and the user is not required to use these procedures in 
every case. 



48-037 F00 R02 s-1 



5.2.1 Processing a Previously Created Configuration Input File 

The following commands will load and start the Sysgen/32 program 
and process a previously created configuration input file: 

*LOAD SYSGEN32 

* START, INPUT-FIGURl.SYS, OUTPUT-MACRO 1 . MAC , LIST=PR: 

-SYSGEN/32 R00-00 

When these commands are entered, the configuration input file 
(FIGUR1.SYS) is processed by the Sysgen/32 program in batch mode. 
The macro calls generated by the Sysgen/32 program are written to 
the output file (MACR01.MAC) . List output is written to the list 
file (PR:). 

The user can now follow the procedures outlined in Chapter 1 for 
expanding the macros, assembling the expanded macros and linking 
the object module to yield an operating system. 

5.2.2 Creating a Configuration Input File Conversationally and 
Processing the Input File 

The following commands will load and start the Sysgen/32 program 
and allow the user to create a configuration input file in the 
conversational mode and then process the newly created file: 

"LOAD SYSGEN32 

*START, LIST=PR: , COMMAND=CON: 

-SYSGEN/32 R00-00 

>INPUT=FIGUR2.SYS 

>0UTPUT=MACR02.MAC <must not exist> 

> CONVERSAT I ONAL 



At this point, a conversational prompt and response session 
begins. (Section 5.3.1 presents a sample conversational prompt 
session.) Each response entered by the user is translated into 
a configuration input statement and then written to the 
designated input file (FIGUR2.SYS) . When the prompt session has 
completed, the user processes the input file by entering the 
following command: 
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> PROCESS 



-END OF TASK CODE=0 

When the Sysgen/32 program has successfully completed processing 
the configuration input file, the output file contains the macro 
calls generated. The user can now follow the procedures outlined 
in Chapter 1 for expanding the macros, assembling the expanded 
macros and linking the object module to yield an operating 
system. 

5.2.3 Creating a Configuration Input File Interactively and 
Processing the Input File 

The following commands will load and start the Sysgen/32 program 
and allow the user to create a configuration input file in an 
interactive mode and then process the newly created file: 

*ALLOCATE F IBUR3 .SYS , IN, 80 
*LOAD SYSGEN/32 

*START , INPUT-F IGUR3 . SYS , 0UTPUT=MACR03 . MAC , LIST=PR : 
, C0MMAND=C0N : 

-SYSGEN/32 ROO-00 
> PROCESS 

READY FOR CONFIGURATION INPUT 
>. 



At this point, the user can interactively enter the required 
sysgen configuration statements. Chapter 2 describes the format 
and content of these sysgen statements. It is important to note 
that the specified input file (FIGUR3.SYS) must be an empty file 
or the interactive prompt will not appear. When the sysgen 
statements have been entered, the following commands are entered 
to complete the input file and begin processing: 



>ENDC 

READY FOR SYSGEN COMMANDS 
> PROCESS 



-END OF TASK CODE=0 
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When the task has reached a successful completion, the macro 
calls generated by the Sysgen/32 program are located in the 
output file, MACR03.MAC. The user can now follow the procedures 
outlined in Chapter 1 for expanding the macros, assembling the 
expanded macros and linking the object module to yield an 
operating system. 

5.3 CREATING A CONFIGURATION INPUT FILE 

As the examples in the previous section show, Sysgen/32 allows 
the user to create a configuration input file in two modes: 

• conversational mode, and 

• interactive mode. 

For the less experienced user, the conversational mode is ideal, 
since the user merely has to respond to a series of prompts 
supplied by the Sysgen/32 program. The user responses are 
translated to create configuration input statements, which are 
written to the configuration input file. This file is then 
processed via the Sysgen/32 PROCESS command. 

The interactive mode reguires more knowledge on the part of the 
user because no Sysgen/32 prompts are issued. The user enters 
sysgen configuration statements interactively from the command 
device and, therefore, must know what statements to include and 
the format of each statement. The sections that follow provide 
examples of creating a configuration input file in both 
conversational and interactive modes. 

5.3.1 Using the Conversational Mode 

A conversational prompt and user response session allows the user 
to create a configuration input file from the command device. 
The responses are translated into configuration input statements 
and are written to the specified configuration input file. This 
file is specified with either the INPUT parameter of the START 
command or with the INPUT command. If a user response to a 
system prompt is not acceptable, the Sysgen/32 program continues 
issuing the prompt until an acceptable response is entered. All 
conversational prompts follow this general format: 

QUESTION (POSSIBLE CHOICES) [DEFAULT CONDITION] 

A conversational session does not end until the Sysgen/32 program 
has issued all of the prompts contained in the conversational 
file. When all of the prompts have been displayed, Sysgen/32 
informs the user that the program is ready to accept Sysgen/32 
commands . 
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At this point, the user specifies the name of the macro output 
file using the Sysgen/32 OUTPUT- command and then begins 
processing of the configuration input file by entering the 
Sysgen/32 PROCESS command. The Sysgen/32 END command terminates 
the session. A successful completion has been reached if an end 
of task code of zero is received. Following is an example of a 
conversational session. 

*LOAD SYSGEN32 

*START, INPUT= FIGURE1.SYS, COMMAND- CON : 

-SYSGEN/32 ROO-OO 
> CONVERS AT I ONAL 

PROCESSOR MODEL (7/32, 8/32, 3210, 3220, 3230, 3240, 3250 
3200MPS, 3205) [3220] 
>3220 

NUMBER OF REGISTER SETS (2 OR 8) [8] 
>8 

O/S VERSION (8 CHAR. ALPHANUMERIC STRING) [BLANKS] 
>3220.N13 

SIZE OF MEMORY IN KB (64-16384, DIVISIBLE BY 16) [256] 
>CR 

DYNAMIC SYSTEM SPACE IN KB (1 TO TOP OF MEMORY) [25] 
>CR 

MAX. NUMBER OF TASKS (1 TO 252) [32] 
>35 

BACKGROUND MAX. PRIORITY (11 TO 248) [16] 
>15 

BACKGROUND MAX. SYSTEM SPACE (0.25 KB INCREMENTS) [9] 
>9 

TIME SLICE [0] 
>40 

POWER FAIL DELAY [5] 
>10 

POWER FAIL RESTART (MANUAL OR AUTO) [ MANUAL 1 
>AUTO 

COMMAND BUFFER LENGTH (32 TO 1024 BYTES) [80] 
>CR 

LOG MESSAGE BUFFER LENGTH (32 TO 132 BYTES) [72] 
>CR 

CSS LEVELS (1 TO 249) [5] 
>5 

NUMBER OF QUEUE ENTRIES (10 TO 64999) [TOTAL NUMBER OF DEVICES1 
>CR 

NUMBER OF JOURNAL ENTRIES (0 TO 12999) [01 
>20 

MAC/MAT ADDRESS (300, 500, 900) [X"300"] 
>CR 

LINE CLOCK FREQUENCY (50 OR 60) [60] 
>60 

PHYS. ADDR. OF PRECISION INTERVAL CLOCK [6C1 
>6C 

LINE FREQUENCY CLOCK ADDR. [6D] 
>6D 
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DATE FORMAT (USA OR EUROPEAN) [USA] 
>USA 



SECONDARY DIRECTORY SUPPORT (YES OR NO) [NO] 
>YES 

INTERCEPT SUPPORT (YES OR NOT) [NO] 
>YES 

MAX. FILE BLOCK SIZE (1 TO 255) [4] 
>10 

DATA AND INDEXED BLOCKS FOR INDEX FILES (d/i) [1/1] 
>4/6 

DATA AND INDEXED BLOCKS FOR SPOOL FILES (d/i) [1/] 
>4/6 

DATA AND INDEXED BLOCKS FOR NON-BUFFERED FILES (d/i) [64/3] 

>64/8 



ENTER STARTUP PROCEDURES (COMMANDS OR CR) [NO STARTUP PROC- ] 
>CR 

MEMORY DIAGNOSTIC SUPPORT (YES OR NO) [NO] 
>Y 

ERROR RECORDING SUPPORT (YES OR NO) [NO] 
^CR 

TCOM SUPPORT (YES OR NO) [NO] 
>Y 

ENTER TCOM NAME 
>TCM1 

ENTER START ADDR OF TCOM 
> 10000 

ENTER TCOM SIZE (IN 0.25 KB INCREMENTS) 
>.25 

COORDINATION (EDMA) SUPPORT (YES OR NO) [NO] 
>Y 

MCONFIG (YES OR NO) [NO] 
>NO 

NAME OF CONSOLE DEVICE (CON:) 
>CON: 

DEVICE STATEMENT SECTION: 

NOTE: TO ADVANCE TO THE NEXT DEVICE TYPE, ENTER A "/" 

IN RESPONSE TO THE NAME PROMPT OF THE CURRENT DEVICE TYPE 

TTY/RP MODEL 33 (CURRENT LOOP INTERFACE) r DCOD 16: 

DEVICE NAME [TTY] 

>/ 
TTY/RP MODEL 33 (CURRENT LOOP INTERFACE) ,DCOD 81: 

DEVICE NAME [TTY] 
>TTY1 

DEVICE ADDRESS [002] 
>002 

INTERRUPT LEVEL [0] 
>0 

IOCLASS [2] 
>2 
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TTY/RP MODEL 33 ( CURRENT LOOP INTERFACE) ,DCOD 81: 

DEVICE NAME [TTY] 
>TTY2 

DEVICE ADDRESS [002] 
>006 

INTERRUPT LEVEL [0] 
>0 

IOCLASS [2] 
>2 

TTY/RP MODEL 33 (CURRENT LOOP INTERFACE) f DCOD 81: 
>/ 

TTY/KP MODEL 35 (CURRENT LOOP INTERFACE) ,DCOD 17: 

DEVICE NAME [TTY] 
>/ 

TTY/RP MODEL 35 (CURRENT LOOP INTERFACE) r DCOD 82: 

DEVICE NAME [TTY] 
>/ 

NONEDITING CRT (Current LOOP INTERFACE), DCOD18 : 

DEVICE NAME [TTY] 
>/ 

CAROUSEL 15, 30, 35 (80 CHARACTERS, CLI), DCOD21: 

DEVICE NAME [TTY] 
>/ 



CONVERSATIONAL PROCESSING COMPLETE 

>OUTPUT=MACR03 .MAC 

> PROCESS 

>END 

-END OF TASK CODE=0 



NOTE 

In a conversational session, there is no 
default for device names and addresses. 
The user must enter a response to the 
device prompt or the program will 
continue to issue the same device prompt 
until a response is received. A slash 
(/) bypasses a device prompt, indicating 
that the device displayed is not desired 
in the system being configured or that no 
further devices of this type are to be 
configured in the system. 

Table 5-1 describes the parameters involved in device prompts 
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TABLE 5-1 DEVICE PROMPT PARAMETER DESCRIPTIONS 



PARAMETER 
DEVICE NAME 

DEVICE ADDRESS 

INTERRUPT LEVEL 

I/O CLASS 
CLOCK A, B, C, D 
SELECTOR CHANNEL 
CONTROLLER 
SPINDLE NUMBER 
TRANSFER RATE 



DESCRIPTION 



SSK««MB9B=XBnSni«1BHSSSl 



4-character mnemonic the system associates 
with a device 

Hexadecimal number specifying the physical 
address of a device 

Decimal number from (highest) to 3 
(lowest) specifying the hardware interrupt 
level for device interruption 

Decimal number from to 31 specifying the 
device or file class 

Baud rate at which data can be transmitted 
to and from a terminal 

2-digit hexadecimal number specifying 
the selector channel (SELCH) address 

2-digit hexadecimal number specifying 
the controller address 

Decimal number from to 3 specifying the 
floppy disk spindle number 

Number of simultaneous transfers if coor- 
dination is specified 



5.3.1.1 Accessing the HELP File in Conversational Mode 

To access the HELP file during a conversational session, enter a 
question mark (?) in response to a program prompt. Information 
pertinent to the last prompt issued will be displayed to the 
command device. 
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Example : 



BACKGROUND MAX. SYSTEM SPACE (0.25 KB INCREMENTS) [9] 
>? 
BACKGROUND: ESTABLISHES BACKGROUND PRIORITY AND SYSTEM SPACE 
COMMAND FORMAT: BACKGROUND [MAXPRI] [,MAXSIZE] 

MAXPRI=DECIMAL NUMBER FROM 11 
THE:OUGH 248 
DEFAULT=16 
MAXSIZE=DECIMAL NUMBER, INCREMENTS OF 
0.25 KB 
DEFAULT=9 
>CR 

BACKGROUND MAX. SYSTEM SPACE (0.25 KB INCREMENTS) [9] 
>10 



5.3.2 A Configuration Input File Created Interactively 

To create a configuration input, file interactively, the user must 
load and start the Sysgen/32 program either with the name of an 
interactive device specified as the command device, or by taking 
the default CON: . 

The user can use the START command format shown in the example in 
Section 5.2.3, or the user can specify only the command device in 
the START command and then specify the input and output files 
using the Sysgen/32 commands, cis shown in the following example. 



Example: 



*LOAD SYSGEN/32 

* START , COMMAND=CON : 



-SYSGEN/32 ROO-OO 
> INPUT = FIGUR1.SYS < 

> OUTPUT- MACR07.MAC < 

> PROCESS 

READY FOR CONFIGURATION INPUT 
>. 



must be an empty file 
must not preexist > 



>ENDC 

READY FOR SYSGEN/32 COMMANDS 
> PROCESS 
>END 
-END OF TASK CODE=0 
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The user enters the sysgen 
following message appears: 



configuration statements after the 



READY FOR CONFIGURATION INPUT 



The ENDC command terminates entry of configuration statements and 
returns the user to the Sysgen/32 command mode. The PROCESS 
command initiates processing of the configuration input file. 
When an end of task code of zero is received, the program has 
reached a successful completion. 

5.3.2.1 Accessing the HELP File in Interactive Mode 

To access the HELP file while creating a configuration input file 
interactively, the user must exit the configuration input mode 
using the ENDC command. The Sysgen/32 HELP command can then be 
used to access the HELP file. When the HELP command is entered, 
the following message is displayed: 



FOR A LIST OF COMMANDS TYPE HELP* 

FOR HELP ON ANY COMMAND MNEMONIC, TYPE HELP <MNEMONIC> 



When the HELP command is entered with an asterisk (*) all 
Sysgen/32 commands and configuration statements are displayed. 
When the HELP command is entered with the mnemonic of a 
configuration statement or Sysgen/32 command, information 
pertinent to that specific mnemonic is displayed. 

Once the user has obtained the desired information from the HELP 
file, the Sysgen/32 EDIT command can be used to continue creating 
the configuration input file. Enter EDIT, get the input filename 
and position yourself to where you left off prior to using the 
HELP command . 
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Example: 



*LOAD SYSGEN/32 

* START , COMMAND=CON : 

-SYSGEN/32 ROO-00 

> INPUT- FIGUR7.SYS < empty input file > 

> OUTPUT= MACR07.MAC < nonexistent output file > 

> PROCESS 

READY FOR CONFIGURATION INPUT 
>VERSION 3220 
>CPU 3220 
>MEM 1024 
>DSYS 150 
>ENDC 

READY FOR SYSGEN COMMANDS 
>HELP ACCOUNTING 

ACCOUNTING: INCLUDES ACCOUNTING SUPPORT 

COMMAND FORMAT: ACCOUNTING [ N ] [ ,NO FILE ACCOUNTING] 
N= Decimal Value from 2 through 32, SPECIFYING THE 
MAXIMUM NUMBER OF ACCOUNTING CLASSES 
DEFAULT FOR N=4 

NO FILE ACCOUNTING SPECIFIES THAT FILE 
ACCOUNTING SUPPORT IS EXCLUDED 
>EDIT 

READY FOR EDIT COMMANDS 
>GET FIGUR7.SYS 
APPEND BOTTOM 
5 ENDC 
7 -1 

4 DSYS 150 
7 INS 
4.01 ACCOUNTING 4 



>DONE 

READY FOR SYSGEN COMMANDS 
> PROCESS 
>END 
-END OF TASK CODE=0 



5.3.3 Modifying a Configuration Input File Via Edit/32 

Regardless of how it was created, a configuration input file that 
contains an error or an improperly specified configuration 
statement can be modified using the Sysgen/32 EDIT command. The 
EDIT command invokes Edit/32 and makes all of the Edit/32 
commaLnds available to the Sysgen/32 user. After modification, 
the input file can then be processed via the PROCESS command. 
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Example : 



*LOAD SYSGEN32 

* START, INPUT- FIGUR1.SYS, COMMAND-CON: 



-SYSGEN/32 R00-00 
>EDIT 

READY FOR EDIT COMMANDS 
>GET FIGUR1.SYS 
>T 1-4 

1 VERSION 3220 

2 CPU 3220 

3 MEM 1024 

4 DSYS 200 

>CHANGE /200/, /150/,4 

4 DSYS 150 

>DONE 

READY FOR SYSGEN COMMANDS 
>OUTPUT- MACROl.MAC 
> PROCESS 
>END 
-END OF TASK CODE=°0 



< invokes editor > 

< specifies file to be edited > 

< displays lines 1-4 > 



< modifies line 4 > 

< saves file and exits Edit/32 > 
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APPENDIX A 
COMPARISON OF SYSTEM GENERATION/32 (SYSGEN/32) 
AND OS/32 CONFIGURATION UTILITY PROGRAM (CUP) 
CONFIGURATION STATEMENT DEFAULTS 



STATEMENT j 


SYSGEN DEFAULT 


=================== 


============ = ============== = 


ACCOUNTING | 


4 


BACKGROUND PR 10 | 


16 


BACKGROUND SIZE | 


9 


CLOCK ! 


60,6C,6D 


CMDLEN | 


80 


CPU | 


3220 


REGISTERS 


8 for all but 7/32 


CSS 


5 


DATE 


MMDDYY 


DEVADADS 





DIRECTORY 


OFF 


D36CBLOCK 


4 


DSYS 


25 


ERRORREC 


OFF 


FLOAT* 


N,N 


FLOAT** 


H,H 


I LEVEL 





INTERCEPT 


OFF 


IOCLASS 


0,1,2,3 


I READER 


NO I READER 


ITAM 


OFF 


JOURNAL, 





LOGLEN 


72 


LPU 


1 


MAXAPU 


9 


MAXTASK 


32 


MCONFIG 


OFF 


MEMCHECK 


OFF 


MEMORY 


256 


PROCESSOR LIMITS: 


16,384 for 3250, 




3240, 




3230 




4,096 for 3210 




1,024 for 3220, 




7/32, 




8/32 


NOSEG 


ON 


TGD 


, NOTGD 


QUEUE 


i NO. OF DEVICES 


RESPONSETIME 


OFF 


ROLL 


i OFF 



ssse: 



CUP DEFAULT 

4 
16 

9 
60,6C,6D 
80 
7/32 

2 

5 
MMDDYY 


OFF 

4 
25 
OFF 
N,N 
H,H 



OFF 

0,1,2,3 

NO I READER 

OFF 



72 

N/A 

N/A 

32 
OFF 
OFF 
128 



ON 

TGD 

NO. OF DEVICES 

OFF 

OFF 
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STATEMENT 

SCREENTIME 

SPOOL+ 

SPOOL++ 

SPL/32 

SSTABLE 

TEMP 

TGD 

VERSION 

VOLUME 



N DEFAULT | 


CUP DEFAULT 






OFF | 


OFF 


SPOOLER | 


SPOOLER 


N/A j 


SPL/32 


SPL/32 | 


N/A 


32 | 


32 


BLANK { 


BLANK 


OFF | 


ON 


BLANK i 


BLANK 


BLANK | 


BLANK 



* CPU, 7/32 t 8/32 

** Perkin-Elmer Series 

4- with parameter 

++ without parameter 



3200 



A-2 
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APPENDIX B 
SYSTEM GENERATION/3 2 (SYSGEN/32) MESSAGES 



ACCOUNTING ERROR 

The maximum number of device or file classes to be supported 
was specified by a decimal number less than 2 or exceeding 
32. 

The ACCOUNTING statement was entered with a conflicting 
NOFILEACCOUNTING parameter. 

ADDRESS ERROR address 

Device address exceeds the maximum allowable range set in the 
DEVADS statement. 



COMMAND DEVICE ERROR 

Specified device or file is syntactically incorrect or failed 
to assign. 

COMMAND NOT RECOGNIZED 

An invalid command mnemonic was entered. 

CONSOLE ERROR 

A console device was not specified, or more than one device 
was specified as a console device. 

CONVERSATIONAL PROCESSING COMPLETE 

All conversational prompts have been displayed. The PROCESS 
command can now be entered. 

COORDINATION ERROR name 

Named device not recognized as a valid device. 
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DUPLICATE START OPTION: XXX 

Start options were entered more than once. 

ERRORS IN ASSEMBLY, SYSGEN ABORTED 

A sysgen command substitution system (CSS) message indicating 
that errors were encountered in the macro assembly phase. 

ERRORS IN MACRO EXPANSION, SYSGEN ABORTED 

A sysgen CSS message indicating that errors were encountered 
in the macro expansion phase. 



FILE DESCRIPTOR ERROR 

A device or filename entered in a command was either invalid 
or omitted . 



INPUT: 
OUTPUT : 
FILE ERROR ON LIST: [Text] 

CONVERSAT I ONAL : 

Text specifies one of the following: 



ACCOUNT ERROR 

ASSIGNMENT ERROR 

BUFFER ERROR 

FILE DESCRIPTOR ERROR 

I/O ERROR 

ILLEGAL FUNCTION 

INVALID LU 

NAME ERROR 

PRIVILEGE ERROR 

PROTECT ERROR 

SIZE ERROR 

SVC7 ERROR 

TGD ASSIGNMENT ERROR 

TYPE ERROR 

VOLUME ERROR 

An error was encountered during the allocation or assignment 
of the device or file identified by file descriptor (fd). 

I LEVEL ERROR i level 

An invalid ilevel value was issued, or an ilevel other than 
was specified with only 2 register sets. 
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ILLEGAL SEPARATOR: xxx 

A separator was omitted or incorrectly entered. 

ADDRESS 
ILLEGAL TCOM: NAME 
SIZE 

TCOM address is not in global memory, TCOMs overlap, the 
names of two TCOMs are the same or the name TSKCOM was 
specified. 



ILLEGAL VALUE: XXXX 

The characters replacing xxxx represent the flagged illegal 
value. 



INPUT FILENAME OMITTED 

A sysgen CSS message indicating the name of the configuration 
input file was not entered as input to the Sysgen/32 CSS 
procedure. 

INPUT FILE filename. SYS DOES NOT EXIST, SYSGEN ABORTED 

A sysgen CSS message indicating that the specified 
configuration input file does not exist. 

INPUT MUST BE ENTERED 

A CONVERSATIONAL or PROCESS command was entered before an 
input file was specified. 

INVALID ARGUMENT: argument 

An illegal argument was located while processing the 
configuration input file. 

INVALID COMMAND IN BATCH: CONVERSATIONAL/EDIT 

The EDIT or CONVERSATIONAL command was entered in batch mode. 

INVALID START OPTION: option 

The program does not recognize a START command option. 
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INPUT: 
OUTPUT : 
I/O ERROR ON LIST: text ON fd 

COMMAND : 

Text specifies one of the following: 

DEVICE UNAVAILABLE 

END OF FILE 

END OF MEDIUM 

ILLEGAL OR UNASSIGNED LU 

ILLEGAL FUNCTION 

PARITY OR RECOVERABLE ERROR 

UNRECOVERABLE ERROR 

fd identifies the assigned file or device on which the error 
occurred. 

LINE XXX ADDR XXXXX STACK OVERFLOW TASK PAUSED 

The program does not have sufficient memory to process the 
input file. Reload the program with a larger segment size 
increment. 

LIST DEVICE ERROR 

The specified device or file is syntactically incorrect or 
failed to assign. 

MACRO FILE filename. MAC DOES NOT EXIST, SYSGEN ABORTED 

This is a sysgen CSS message output in macro expansion phase 
indicating that the filename of the macro output file does 
not exist. 

MACRO LIBRARY filename. MLB NOT FOUND, SYSGEN ABORTED 

This is a sysgen CSS message indicating a required macro 
library was not found. 

MAX. NUMBER OF TCOMS EXCEEDED 

Too many TCOMs were specified. 



Less than two direct access devices were included in the 
system. 
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MISSING ARGUMENT 

A required argument was omitted. 

MODULE NOT INCLUDED: module name 

The module identified by module name was not included in the 
system. There might be a combination of invalid option 
settings . 

NO DEVICES 

No devices were specified in the input file. 

NO DIRECT ACCESS SUPPORT 

DIRECTORY, ROLL, SPOOL, TEMP or VOLUME statements were 
entered, but no disk devices were specified. 

OBJECT LIB filename NOT FOUND, OS LINKING ABORTED 

This is a sysgen CSS message indicating that a required 
system or driver object library was not found. 

OS32MT rr-uu.vvvvvvvv 

This is the 8-character operating system version with 
revision and update numbers displayed on the system console 
at system initialization. 

OUTPUT FILE ERROR: XXX 

The output file already exists, or the fd is incorrect. 

OUTPUT MUST BE ENTERED 

The output file was not specified. 

READY FOR CONFIGURATION INPUT 

The program is waiting for the user to interactively enter 
configuration input statements to be used to create the 
configuration input file. 

READY FOR EDIT COMMANDS 

The editor was invoked via the EDIT command, and the system 
is waiting for edit commands. 
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READY FOR SYSGEN COMMANDS 

The OS/32 EDIT END or DONE command ended the edit session and 
control is returned to the sysgen program. The Sysgen/32 
program is waiting for commands to resume processing the 
configuration input file. 

SEQUENCE ERROR 

The statement preceding the message was entered more than 
once, or a corresponding required statement was omitted. 

The ILEVEL or IOCLASS statement was entered after all devices 
were processed; i.e., after the ENDD statement was read. 

SPECIFIED FILE filename DOES NOT EXIST, LINK OF OS ABORTED 

This is a sysgen CSS message indicating that a file required 
in the Link procedure cannot be found. 

STATEMENT NOT RECOGNIZED 

A statement in the input file is not recognized by the 
program. 

SYSGEN32 ERROR, SYSGEN32 ABORTED 

An error in running the Sysgen/32 program was detected. The 
sysgen procedure is aborted. 

XXXX ERROR 

The characters replacing xxxx specify ROLL, SPOOL, SPL32, 
TEMP, VOLUME, MEMORY, MODULE , FLOAT, ILEVEL, ERROR RECORDING, 
ACCOUNTING, NAME, ADDRESS, DCOD, SELCH or COORDINATION. 

Invalid syntax was detected in the volume. 

More than 16 pseudo devices were specified (SPOOL), or spool 
support was requested but no pseudo devices were found. 

The memory specified exceeds the allowed range for the 
requested central processing unit (CPU). 

A MODULE statement was entered with a name that could not be 
recognized by the program, or the MODULE name was 
syntactically incorrect. 
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Invalid floating point options or combinations were entered: 
no single precision floating point (SPFP) , but hardware 
double precision floating point (DPFP) , or, for the 
Perkin-Elmer Series 3200 CPUs, the options were H r S or S,H. 

The SELCH, controller and connected devices have different 
I LEVELS. 

A syntax error was detected in the name field of a device 
statement, the same name was entered twice, or a blank device 
name was found. 

The device address was invalid, greater than the maximum 
physical address specified, or not for spool devices. The 
device address was 0, indicating a spool device, but the 
device code was not or one. 

The specified device code was invalid, not a number from 16 
to 254, or not or 1 for spool devices. 

More than one device specified the same controller with 
different SELCH specifications. 
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APPENDIX C 
SYSTEM GENERATION/32 (SYSGEN/32) COMMAND AND STATEMENT SUMMARY 



ACCOUNTING [=] 



kNOF I LEACCOUNT I NGJ 



BACKGROUND [>1 



(maxpriority) 



LI 



Ulii ■ L 



CLOCK H 



roi 



(pic addr)~ 



(lfc addr} 



GdI 



CMDLEN H 



in 



CONVERSATIONAL 



COORDINATION^*] 



SELCH= 



Si 
(s 1 ,s 2 ,S ri ) 



'DEVICE- 



name 1 
(namei , . . . ,name n ) 



, TRANSFER=n 



COPY 
line/ 

JLine n _ 
ENDCOPY 
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C-l 



£EU Q3 




ess Q£] 



in 



DATE [V] 




DEY&DS H 



C-2 
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DEVICES 

dev name:,dev address r dov dcode 



XA) 

,£LQCK=JXB( 

XC( 

xd) 



ECM=n] 



|Q CONSOLE] QcQHIROLLER-n] [DISC] [7 DUAL] QeOv] QlLEVEL-n] 



,JLNIIMER 



-r \~ 

mm. 



rlQCLASS- 



n 



■acK*- t/O cl»M 



,1QLIMIT' 



•! n [ 

mm 



[7JLEAPCOUNT~ri] QLlNESTATUS-rQ QMAXERAMES=nj 

Lmaxhri 



TEBUFF 






"{-}] 



,M1NREADBUFF- 



{., J (7MTO=rQ 'N2-| I 



L (mi. 



[7 MOD I S C~J [7_ MOMSH ARE!)) 



,QUTIMER= 



n 



,£OLLTIME 



•q] 



[7£ADCOUNT-n] [7_POLLDELAY=n] GEQLLIMIT=rf) 
jTOUEUE-name] [7READCONTROL-H] QRECLEN-n] 
,BE£PONSETIME=< } (7sCREENTIME«rf) QfiELCH-n] f£lZE»n] 



(TjSEINDLE-n] QsSA=name 



9 J Lt02-|" J 



Q IBANSLATE-name] 



QuSCI-ri] QusC0-nj [,USER=(uparm (^parameter] )] 



GviRT-(startcyl,ncyl)~J 
[7_XDCOD-n] 



, MAKEUP 



-r ii 



[7 WRITE CONTROL-n] 



ENDD 



48-037 F00 R02 



C-3 



i DISC BLOCK Q£] 



»,MXBLKSZ 




,1NDEX= 



r SPOOL= 



,NQNBUF= 



rri/rrn 

ibsize) /fisiz©|~| 
t j/i m U 

jize) Aisize) - 

■ Kl l L 



DSYS 03 



Llm! 



EDIT 



END 



ENDC 



ERRQRREC Q{] fd, size, per iod 







V S 


,s 






J S,H 


ELOAT 








"(name)" 




HELP 


< > 






J * 







C-4 
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1LEVEL H 




INPUT fd 
INTERCEPT 



JLQCIASS H 




1READER 
1IAM 
JOURNAL H 

LOGLEN H 



M 



LPU 



] n ! 

(maxapu value) 



Eff 
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MAXAPU 



APUi ,contr 1 
APU 2 f contr2 



APU n , contr n 
ENDAPU 



MAXTASK [3 



n 



MCQUE I G £LOCK=nn , SIART=xx , JRANGE=yy 

/NQRECORD' 
, aHARED=<MVRECORD ' 

(record 



,JHTERL={4: 

W 



MEMCHECK 



MEMORY H 



n 



MODULE 



new module name.," 



new module name 2 

new module name n 
ENDM 



NQSEG 



£QWEfiFAIL OH 



Rn) 



AUTO 



C-6 
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fiUTPUT fd 

E&USE 

EROCESS 

QUEUE IXI 



n 



filial nujabftt of d«vlce*t 



ROLL H [rvolrf] 
SLICE [-][n] 
SROOL |X1 [spvoln] 



SRL32 



SSXABLE [V] 



n 



START |7lNPUT-fd{] (7<3UTPUT=f d£] Q£OMMAND=f d£] QLIST-fd^ 



STARTUP 



ENDS 



TCOM [«] name-, , address., , size! (/. . ./name n ,addres9 n ,size^] 
TEMP H Dtvoln] 



IGD 



VERSION Q«] [yvvvvvvv] 
VOLUME Q=] [volri] 
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APPENDIX D 
SYSTEM GENERATION/32 (SYSGEN/32) AND OS/32 
CONFIGURATION UTILITY PROGRAM (CUP) STATEMENT COMPARISONS 



SYSGEN/32 STATEMENTS 



ACCOUNTING [-] 




QUOF I LEACCOUNT ING] 



BACKGROUND H 



f 



maxpriority) 



CLOCK H 



[OlEC 



16 



pic addr) 



jJlli ■ L 



(lfc addr) 



M 



CMDLEN H 



£QQaDINATI0N[3 



COPY 
line! 

_linen_ 
ENDCOPY 




i SELCH= 



Si 



JQEVICE= 



name, 



(nam«i , . . . , namen) 



, TRANSFER=n 



OS/32 CUP STATEMENTS 



ACCOUNTING 



BACKGROUND 



nrri 



(maxpriority) 



(maxs 



LI 



size)" 



CLOCK 



CMDLEN 



Ba- 
re 



(pic addr) 

\ mmm. \ 



,lfc addr) 

. UK ! 



M 



d 

I 

to 



00 

I 

O 
w 
>J 

O 
o 

5» 
o 



SYSGEN/32 STATEMENTS 



CEU H 




:lii 



- H Kl] 

r^DDfMYYn 



DATE [*] 






deszads H 




OS/32 CUP STATEMENTS 



C£U 




ess 



ni 




DATE 




DE5Z&DS 



00 

I 
o 

Tl 
O 
O 

o 



SYSGEN/32 STATEMENTS 



OS/32 CUP STATEMENTS 



D 

w 



DEVI CES 

dev name:,dev address, dev dcode 



ENDD 



XA 

£LfiCK=JXB 

XC| 

XD 



(7CM=n] 



QCQHSOLEj QcQMXROLLER-n] QDIS(Q QdUAL) Qeov] QxLEVEL-n] 



LlMIMER-',., > ,XQCLASS-1 

L in) J L \. 



I global I/O ci»93 I 

[7LEADC0UNT»n] QLlNESTATUS-n] |] MfiXERAMES-ri] 

( n I 



1 rJJJLIMIT-^ > 

)JL <!§*- 



[' 



MAXHRITEBUFF- 



l;A02*L 



.MIMREADBUFF- 



lil] CMro ^ hill 



ENCS-! I 



QhqdiscQ [7nqhshared] 



,quiimer 



iioL 



rEADCOUNT-ril ITPOLLDELAY-nl r,PQLLIMIT-n] 



EOLLT 



IME- < ... > 



EBSPONSETIME=< . > [7S£REENTIME=n] nSELCH-ri] rsj.ZE=ri] 



fOUEUE-name] |7EEADCONTROL-n] QEE£LEN-n] 

[7S£INDLE«n] QsSA=name] Lt02-<.........S [TlRANSLATE-nanKf] 

QuSCI-n] QusCO-ri] HuSER- (uparm(j>paraineter] )] 
QviRT-(startcyl,ncyl)] , MAKEUP -L ...,,> [7HKlXECONTROI>n] 
(TxDCOD-n] 



DEYJ.CES 
jlevel) 



> [clmnem] :dnum,dcod r )d ( ,< > ,< > 

) J E f L (Xxdcod)J L ttll )_ 

!size}~ 



(level| 



(size) 

in L 



!xdcod Y 
Xxdcod ) 



free 11 



ENDD 



D 

i 



SYSGEN/32 STATEMENTS 



DIRECTORY 



| DISC BLOCK (j£J 



Q 



l,MXBLKSZ= 



■i; 



,1NDEX=< 



,S£OOL= 



(bs 



(bsi 



i 
rbs 



,HQNBUF=< 



no 

nrro 

ize) /(isizel" 



00 

I 

o 
w 

-o 

Ti 
O 
O 

!» 

o 

to 



DSYS [=3 



111 



OS/32 CUP STATEMENTS 



DIRECTORY 



DISCBLOCK 



[0] 



DSYS 






00 

I 

o 
oo 
<J 

•fl 
o 
o 

JO 

o 



o 

I 
en 



SYSGEN/32 STATEMENTS 






EESQBEEC JXJ fd f size, period 



EJ.0AT = 




"(name}"" 

help Li - 1. 



ILEVEL H 




OS/ 3 2 CUP STATEMENTS 



EHDC 



EESQEEEC fd, size, per iod 



ELOAT 




ILEVEL 




a 



SYSGEN/32 STATEMENTS 



OS/32 CUP STATEMENTS 



oo 

t 
o 

*J 

tl 
o 
o 

JO 

o 



IHTJBRCEPT 



IQCLASS H 




iREADER 



HAM 



JOURNAL H 




LOGLEN Q=) 






IQCLASS 




ITAM 



JOURNAL 



LOGLEN 



SO 



oo 
I 

o 
w 
«J 

Ti 
o 
o 

JO 

o 

to 



D 

I 



SYSGEN/32 STATEMENTS 



LPU 



\~1 r ^"~l 



JjiAXAP® valaej J {_ \%)J 



MAXAPU 



APUi r contr! 
APU 2 t contr 2 



APU n , contra. 
ENDAPU 



M&XTASK H 



[U] 



OS/32 CUP STATEMENTS 



MCQNEIG BLOCK»nn,SIART=xx,E&NGE=yy 

/nqrecowt 
, shared=<nvrecord ' 
(eecord 

MEMCHECK 



,1MTERL={4> 

D 



MfiXTASK 






MEMCHECK 



o 

do 



CD 

I 

o 

CO 



o 
o 

o 



SYSGEN/32 STATEMENTS 



MEMORY H 



Imp 



MODULE 

new module namef 
new module name 2 

new module name n 
ENDM 

HQSEG 



I JEQHEEFAIL (VJ 



AUTO 



QUEUE |V] 



n 



(total twtibvt tsf cS©¥ic«sl 



OS/ 3 2 CUP STATEMENTS 



MEMORY 



n 



MODULE 






new module 


name 




new module 


name 




new module 


name 


ENDM 




NQSEG 




NQIGD 





QUEUE 



n 



(total nmt$><&t of <$*¥4S^si 



00 

I 

o 
w 
>J 

•n 
o 
o 

fo 
o 

to 



SYSGEN/32 STATEMENTS 



BOLL H [rvolifj 
SLICE [«][n] 
SECX)L H [spvoln] 



SEL32 



SSTA BLE [=] 



U 



STARTUP 



ENDS 



ICOM [*\ name, , address, , size, (7- . ./name n ,addres3 n ,size,j] 



OS/32 CUP STATEMENTS 



BOLL (rvolnj 



SP.00L (spvolnj 
SEOOL 



SSIABLE 



STARTUP 



ENDS 



rtn 

Jim- 



ICOM name, .address, ,size, [7- • ./name n ,address n .sizej 



O 
I 



a 

i 

O 



SYSGEN/32 STATEMENTS 



OS/32 CUP STATEMENTS 



00 

i 
o 

-J 

o 
o 

po 
o 



TEMP [=] [tvoln] 



2GD 
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PERKIN-ELMER 
Data Systems Group 

DOCUMENTATION CHANGE NOTICE 



The purpose of this documentation change notice (DCN) is to 

manual bef'orfthe'v I" 1 ? 1 "*,?* °5 ~**»<*™*~ to technical 
manuals before they are formally updated or revised. 

The manual affected by these changes is: 



la-oaz ma so2 system generation./^ (sxsgen/32) R.fl^ 

Manual 



• Page 4-2 and 4-9 

The local device codes for the CDD50 disks are stated 

IT^hf^, In ? ble 4_1 ° n Page 4 " 2 ' and in Table "2 on page 
4-9, the device codes are reversed. Hy 

The Tables should read: 

LOCAL DEVICE CODE DEVICE TYPE 

42 50M t> CDD50, removable portion (25Mb) 

43 50Mb CDD50, fixed portion (25Mb) 
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PUBUCATION COMMENT FORM 



We try to make our publications easy to understand and free of errors. Our 
users are an Integral source of information for Improving future revisions. 
Please use this postage paid form to send us comments, corrections, 
suggestions, efc. 



1. Publication number_ „. 

2. Title of publication 



3. Describe, providing page numbers, any technical errors you 
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4. Was the publication easy to understand? If no. why not? 



5. Were illustrations adequate? 



6. What additions or deletions would you suggest? 



7. Other comments: 
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